Getting started

Novolis storage provides a shared IRepository<T> abstraction with JSON, SQLite, in-memory, direct Azure Tables, and preview Azure Combined Storage implementations, plus direct typed Azure Blob containers. Querying is an optional finite capability.

Prerequisites

• .NET 10 SDK

Build

dotnet build Novolis.Storage.slnx

JSON storage

services.AddJsonDataStorage<MyEntity>(configuration);

SQLite storage

services.AddSqliteDataStorage<MyEntity>(configuration, databaseName: "app.db");

Azure Combined Storage

services.AddStorage(builder => builder.AddAzureCombinedStorage(options =>
{
    options.ConnectionString = connectionString;
    options.AddIndex<MyEntity>("name", entity => entity.Name);
}));

var repository = serviceProvider.GetRequiredService<IRepository<MyEntity>>();
var page = await repository
    .Query()
    .Where(entity => entity.Name).StartsWith("Ada")
    .Take(100)
    .ToPageAsync(cancellationToken);

The provider stores the published manifest in Azure Tables and immutable aggregate payloads in Azure Blobs. Indexes are derived state and can be rebuilt or repaired through IAzureCombinedMaintenance<T>.

Azure Blob containers

services.AddStorage(builder => builder.AddAzureBlobStorage(options =>
{
    options.ConnectionString = connectionString;
    options.ContainerName = "documents";
}));

var documents = serviceProvider.GetRequiredService<IBlobContainer<Document>>();
await documents.UpsertAsync(document, cancellationToken);
var stored = await documents.TryGetAsync(document.Name, cancellationToken);

Document implements IHasName. The name is the Azure blob name. This provider stores JSON directly in Blob Storage and has no query or index layer.

See also

• Design
• Release