CoreDesign.Shared 1.0.2

CoreDesign.Shared

Shared infrastructure, error result types, and utility extension methods for .NET projects. Intended to be referenced by both host/API projects and AppHost projects.

Requirements

• .NET 10.0
• Microsoft.EntityFrameworkCore 10.x
• Microsoft.Extensions.Configuration.Abstractions 10.x
• Microsoft.Extensions.Configuration.Json 10.x
• Microsoft.Extensions.DependencyInjection 10.x
• Microsoft.Extensions.Options 10.x
• Aspire.Hosting.AppHost 13.x
• Ulid 1.4.x

What Is Included

Infrastructure

DatabaseOptions

A record that holds the database connection settings read from configuration:

Configuration (extension methods)

Error result records

Lightweight result records for use with discriminated unions (e.g., OneOf):

Each record carries a single string Message property.

Extension Methods

ObjectExtensionMethods

Note: DeepClone requires the type to be serializable by System.Text.Json. Types with non-default constructors may need a [JsonConstructor] attribute.

StringExtensionMethods

Setup

1. Install the NuGet package

Using the .NET CLI:

dotnet add package CoreDesign.Shared

Using the NuGet Package Manager Console:

Install-Package CoreDesign.Shared

Or add directly to your .csproj:

<ItemGroup>
    <PackageReference Include="CoreDesign.Shared" Version="*" />
</ItemGroup>

2. Add the DatabaseOptions section to appsettings.json

{
  "DatabaseOptions": {
    "HostName": "my-sql-server",
    "DatabaseName": "MyDatabase",
    "HostPort": 1433,
    "ConnectionStringName": "MyDatabase"
  }
}

3. Register configuration in your host

Call both extension methods during startup to load settings and bind database options:

builder.AddAppSettings();
builder.AddDatabaseConfiguration();

Then resolve DatabaseOptions wherever needed:

var dbOptions = builder.Configuration
    .GetSection(nameof(DatabaseOptions))
    .Get<DatabaseOptions>();

Usage

Error results with OneOf

public async Task<OneOf<Widget, NotFoundMessage>> GetAsync(Ulid id, CancellationToken ct)
{
    var widget = await repository.GetAsync(w => w.Id == id, null, ct);
    if (widget is null)
        return new NotFoundMessage($"Widget {id} not found.");
    return widget;
}

Deep clone

var copy = original.DeepClone();

JSON file round-trip

myObject.SaveToJsonFile("output.json");
var loaded = "output.json".LoadObjectFromJsonFile<MyObject>();

String conversion

var number = "42".To<int>();
var date = "2026-01-15".To<DateOnly>();

Feedback

Feedback on this package is welcome. If you run into a missing feature, an unexpected behavior, or something that required more effort than it should have, open an issue at github.com/codyskidmore/CoreDesign/issues or tag @codyskidmore. Suggestions about missing features and priority input are especially appreciated.