InterfaceDB 1.0.0-preview.7

This is a prerelease version of InterfaceDB.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package InterfaceDB --version 1.0.0-preview.7
                    
NuGet\Install-Package InterfaceDB -Version 1.0.0-preview.7
                    
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="InterfaceDB" Version="1.0.0-preview.7" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="InterfaceDB" Version="1.0.0-preview.7" />
                    
Directory.Packages.props
<PackageReference Include="InterfaceDB" />
                    
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 InterfaceDB --version 1.0.0-preview.7
                    
#r "nuget: InterfaceDB, 1.0.0-preview.7"
                    
#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 InterfaceDB@1.0.0-preview.7
                    
#: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=InterfaceDB&version=1.0.0-preview.7&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=InterfaceDB&version=1.0.0-preview.7&prerelease
                    
Install as a Cake Tool

InterfaceDB

Interface-first object repositories and embedded object storage for .NET 10, licensed under MIT.

InterfaceDB provides typed IRepository<T> APIs, MessagePack envelope serialization, file-per-object storage, indexes, repository notifications, revision-based write-conflict checks and optional retained editing. It is an embedded library; a database host does not authenticate application users on its own.

InterfaceDB.Storage.SegmentCore is the separate MIT append-only segmented-storage provider. Use only providers appropriate to your application and qualify durability behavior on your target filesystem/device.

dotnet add package InterfaceDB --prerelease
dotnet add package InterfaceDB.Storage.SegmentCore --prerelease

Preview.7 maintenance APIs

This source includes opt-in local compaction policies, activity/window hints, shared maintenance I/O budgets and bounded maintenance summaries. They are separate from logical entity Created/Changed/Deleted notifications. Constructing a policy does not start a background job, and physical relocation does not change an entity's revision timestamp.

Segment Core's optional independent cleanup output preserves retained editing baselines and uses durable checkpoints before retiring old files. Online compaction requires the mutation-WAL protocol. Independent output is an explicit durable format 1.1 opt-in; default stores remain format 1.0. Take and verify a backup before enabling it. Older runtimes reject the upgraded format, and changing the compaction setting back does not downgrade a store.

Performance is workload-dependent. Copying, metadata probes, checkpoints and reader/handle retirement have costs; no zero-overhead or lock-free publication guarantee is made. File-per-object storage has no segment-compaction operation.

These capabilities are included in preview.7. New writes use IDB6; preview.6 cannot read them. Stop old writers, rebuild custom providers/envelopes/serializers, and retain a complete pre-upgrade backup. Readers accept IDB2 through IDB6. Review the matching release notes before upgrading; APIs and storage formats may still change before stable 1.0.0.

Source and usage documentation: InterfaceDB repository, including documentation/compaction-maintenance.md, documentation/segment-core-storage-provider.md, documentation/envelope-revisions.md and documentation/retained-editing.md.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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 (1)

Showing the top 1 NuGet packages that depend on InterfaceDB:

Package Downloads
InterfaceDB.Storage.SegmentCore

High-throughput append-only SegmentCore storage provider for InterfaceDB.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-preview.8 73 9/6/2026
1.0.0-preview.7 65 9/6/2026
1.0.0-preview.6 71 9/5/2026
1.0.0-preview.5 69 9/2/2026
1.0.0-preview.4 68 9/1/2026
1.0.0-preview.3 75 8/26/2026

Preview 7 adds revision-checked writes, optional repository notifications, retained editing and maintenance controls, with lower-allocation object scans. New writes use IDB6; readers accept IDB2-IDB6. Stop old writers, rebuild custom integrations and retain a complete pre-upgrade backup; preview 6 cannot read IDB6. See preview7-release-notes.md for compatibility, qualification and remaining limits.