FluxFlow.Components.Storage.SqlFile 1.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package FluxFlow.Components.Storage.SqlFile --version 1.0.0
                    


                    

                
NuGet\Install-Package FluxFlow.Components.Storage.SqlFile -Version 1.0.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="FluxFlow.Components.Storage.SqlFile" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="FluxFlow.Components.Storage.SqlFile" Version="1.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="FluxFlow.Components.Storage.SqlFile" />
                    


                            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 FluxFlow.Components.Storage.SqlFile --version 1.0.0
                    


                    

                
#r "nuget: FluxFlow.Components.Storage.SqlFile, 1.0.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 FluxFlow.Components.Storage.SqlFile@1.0.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=FluxFlow.Components.Storage.SqlFile&version=1.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=FluxFlow.Components.Storage.SqlFile&version=1.0.0
                    


                            Install as a Cake Tool

FluxFlow.Components.Storage.SqlFile

Single-file SQL storage adapter for FluxFlow.Components.Storage.

This package does not add workflow nodes. It provides an IStorageStore implementation and registration helpers for the existing storage nodes:

  • storage.put
  • storage.get
  • storage.query
  • storage.delete

Register

var registry = new RuntimeNodeFactoryRegistry()
    .RegisterStorageComponents(options => options
        .UseSqlFileStorage(new SqlFileStorageStoreOptions
        {
            DatabasePath = "data/storage.db",
            DefaultCollection = "items"
        }));

Set StorageComponentOptions.UseClock(...) when node results and adapter records should share a deterministic time source. SqlFileStorageStore also accepts SqlFileStorageStoreOptions.Clock for direct store use or an adapter-specific override.

Behavior

  • one record table per database file
  • store, collection, and key primary key
  • create, replace, and upsert write modes
  • optimistic version checks through ExpectedVersion
  • expiration honored by storage.get and storage.query
  • query by collection, key prefix, attributes, stored time bounds, expiration, offset, and limit
  • owned store lifetime when created through UseSqlFileStorage

The adapter is intended for single-machine workflows, service hosts, and desktop apps that need a durable local store with stronger coordination than per-record JSON files.

Options

Option Purpose
DatabasePath Required database file path.
StoreName Optional fallback store name when the node does not set store.
CreateDatabase Allows creating the database file when it does not exist.
CreateDirectory Creates the parent directory when it does not exist.
AllowAbsoluteDatabasePath Allows absolute database path values.
MaxValueBytes Rejects values whose serialized JSON exceeds the limit.
DefaultCollection Optional fallback collection.
BusyTimeoutMilliseconds Wait time for a locked database before failing.
Clock Optional direct-store time source override.

The package persists only neutral StorageRecord data. Hosts that need exact payload shaping should compose serialization or payload nodes before storage.

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 was computed.  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 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

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 44 6/4/2026
0.3.0-alpha.1 38 6/3/2026
0.2.0-alpha.1 42 6/2/2026
0.1.0-alpha.1 45 6/2/2026

Stable 1.0.0 component package boundary for FluxFlow.Engine 1.0.0 with package-owned contracts, neutral diagnostics, and release readiness documentation.