SoftwareDriven.Persistence.IndexedDb 3.0.0

SoftwareDriven.Persistence.IndexedDb

Browser IndexedDB provider for SoftwareDriven.Persistence, designed for Blazor WebAssembly and Blazor Hybrid scenarios. Targets net8.0 and net10.0.

Installation

dotnet add package SoftwareDriven.Persistence.IndexedDb

Setup

// Program.cs
builder.Services.AddIndexedDb();
builder.Services.AddSingleton<IndexedDbRepositoryProvider<MyModel>>();

var host = builder.Build();

// Register object stores before connecting
var manager = host.Services.GetRequiredService<IndexedDbManager>();
manager.RegisterObjectStore<MyModel>();        // store name defaults to type name
manager.RegisterObjectStore<MyModel>("Items"); // or with custom store name
manager.RegisterFileStore("_files_Items");     // for file storage
await manager.Connect("MyDatabase");

await host.RunAsync();

Multi-instance (keyed DI)

builder.Services.AddIndexedDb("InstanceA");
builder.Services.AddIndexedDb("InstanceB");

var managerA = host.Services.GetRequiredKeyedService<IndexedDbManager>("InstanceA");

Usage

@inject IndexedDbRepositoryProvider<MyModel> Provider

// CRUD
await Provider.CreateOrUpdate(new MyModel { Title = "Hello" });
var item = await Provider.FindById("some-id");
var results = await Provider.FindByExpression(x => x.Title == "Hello");
await Provider.Delete("some-id");

// Pagination
var page = await Provider.GetAll(new PaginationOptions<MyModel>
{
    PageSize = 10,
    PageNumber = 0
});

// File storage (stored as Base64 in a separate object store)
await Provider.StoreFile("doc.pdf", fileBytes);
var data = await Provider.LoadFile("doc.pdf");
await Provider.DeleteFile("doc.pdf");

Important Notes

• Object stores must be registered before Connect() is called, because IndexedDB only allows store creation during version upgrades.
• Uses IJSRuntime for all IndexedDB operations via a bundled, minified JS module.
• Expression-based queries load all records from the store and apply LINQ in-memory. This is efficient for typical client-side dataset sizes (hundreds to low thousands of records).
• ID-based operations (FindById, Delete, CreateOrUpdate) use direct IndexedDB key lookups without loading all data.

Features

• SupportsTotalCount: true
• SupportsPagingState: false (offset-based pagination)
• DefaultIdSource: GuidSource
• Full IPersistenceProvider<T> support including nested collection projections, element match, and file storage

License

MIT