CoreStone.SDK.Dotnet.Configuration 1.5.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package CoreStone.SDK.Dotnet.Configuration --version 1.5.0
                    


                    

                
NuGet\Install-Package CoreStone.SDK.Dotnet.Configuration -Version 1.5.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="CoreStone.SDK.Dotnet.Configuration" Version="1.5.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="CoreStone.SDK.Dotnet.Configuration" Version="1.5.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="CoreStone.SDK.Dotnet.Configuration" />
                    


                            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 CoreStone.SDK.Dotnet.Configuration --version 1.5.0
                    


                    

                
#r "nuget: CoreStone.SDK.Dotnet.Configuration, 1.5.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 CoreStone.SDK.Dotnet.Configuration@1.5.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=CoreStone.SDK.Dotnet.Configuration&version=1.5.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=CoreStone.SDK.Dotnet.Configuration&version=1.5.0
                    


                            Install as a Cake Tool

CoreStone.SDK.Dotnet.Configuration

Core HTTP client, token management, and shared types for the CoreStone .NET SDK.

This package is required by all other CoreStone SDK packages. Install it first, then add feature packages as needed.

Installation

dotnet add package CoreStone.SDK.Dotnet.Configuration

Quick Start

// Program.cs (ASP.NET Core or MAUI)
builder.Services.AddCoreStoneConfiguration(options =>
{
    options.BaseUrl    = "https://api.yourapp.com";
    options.ProjectKey = "prj-xxxxxxxxxxxxxxxx";   // From CoreStone Management → Projects → API Integration
    options.TimeoutSeconds = 30;
});

Then add feature packages on top:

dotnet add package CoreStone.SDK.Dotnet.Auth
dotnet add package CoreStone.SDK.Dotnet.Analytics
dotnet add package CoreStone.SDK.Dotnet.Support
dotnet add package CoreStone.SDK.Dotnet.UserManagement
dotnet add package CoreStone.SDK.Dotnet.MenuManagement
dotnet add package CoreStone.SDK.Dotnet.Announcement

Custom Token Store

By default tokens are kept in-memory (InMemoryTokenStore). For MAUI apps, provide a secure store:

// MAUI — tokens survive app restarts via Keychain / Android Keystore
builder.Services.AddCoreStoneConfiguration(
    options => { options.BaseUrl = "..."; options.ProjectKey = "..."; },
    tokenStore: new MySecureStorageTokenStore());   // implements ITokenStore

What's Included

Type Description
CoreStoneSdkOptions Configuration options (BaseUrl, ProjectKey, Timeout)
ITokenStore Abstraction for JWT token storage
InMemoryTokenStore Default in-memory implementation
CoreStoneHttpClient Shared HTTP client with auto token refresh on 401
ApiResponse<T> Envelope type matching the CoreStone API response shape
CoreStoneException Typed exception with machine-readable Code property

Error Handling

try
{
    var me = await authClient.MeAsync();
}
catch (CoreStoneException ex) when (ex.Code == "UNAUTHORIZED")
{
    // Token expired and refresh failed — redirect to login
}
catch (CoreStoneException ex) when (ex.Code == "NETWORK_ERROR")
{
    // No internet connection
}
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 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (9)

Showing the top 5 NuGet packages that depend on CoreStone.SDK.Dotnet.Configuration:

Package Downloads
CoreStone.SDK.Dotnet.Auth

CoreStone SDK — authentication: register, login, refresh token, logout.
CoreStone.SDK.Dotnet.Announcement

CoreStone SDK — announcements (fetch active announcements for the app).
CoreStone.SDK.Dotnet.Analytics

CoreStone SDK — analytics event tracking with automatic batching and flush.
CoreStone.SDK.Dotnet.MenuManagement

CoreStone SDK — app menu management (fetch dynamic menus).
CoreStone.SDK.Dotnet.UserManagement

CoreStone SDK — user profile management (get, update, delete account).

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.5.0 287 6/22/2026
1.4.0 268 6/18/2026
1.3.0 240 6/18/2026
1.2.0 243 6/18/2026
1.1.0 245 6/18/2026
1.0.9 221 6/17/2026
1.0.8 222 6/17/2026
1.0.7 227 6/17/2026
1.0.6 225 6/15/2026
1.0.5 225 6/15/2026