WalFlow.Stores.DynamoDb 0.1.0-alpha.alpha.20260708090623

This is a prerelease version of WalFlow.Stores.DynamoDb.

dotnet add package WalFlow.Stores.DynamoDb --version 0.1.0-alpha.alpha.20260708090623

NuGet\Install-Package WalFlow.Stores.DynamoDb -Version 0.1.0-alpha.alpha.20260708090623

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="WalFlow.Stores.DynamoDb" Version="0.1.0-alpha.alpha.20260708090623" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="WalFlow.Stores.DynamoDb" Version="0.1.0-alpha.alpha.20260708090623" />
                    

                            Directory.Packages.props

<PackageReference Include="WalFlow.Stores.DynamoDb" />
                    

                            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 WalFlow.Stores.DynamoDb --version 0.1.0-alpha.alpha.20260708090623

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: WalFlow.Stores.DynamoDb, 0.1.0-alpha.alpha.20260708090623"

#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 WalFlow.Stores.DynamoDb@0.1.0-alpha.alpha.20260708090623

#: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=WalFlow.Stores.DynamoDb&version=0.1.0-alpha.alpha.20260708090623&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=WalFlow.Stores.DynamoDb&version=0.1.0-alpha.alpha.20260708090623&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

WalFlow.Stores.DynamoDb

Amazon DynamoDB-backed IReplicationStore for WalFlow.
Stores ReplicationState entries in a single table keyed by slot name.

Install

dotnet add package WalFlow.Stores.DynamoDb

Configuration

{
  "DynamoDbStore": {
    "TableName": "walflow_state",
    "Region": "us-east-1",
    "AutoCreateTable": true
  }
}

For LocalStack or DynamoDB Local:

{
  "DynamoDbStore": {
    "TableName": "walflow_state",
    "ServiceUrl": "http://localhost:4566",
    "Authentication": {
      "AccessKeyId": "test",
      "SecretAccessKey": "test"
    },
    "AutoCreateTable": true
  }
}

Settings

Setting	Type	Default	Supported values	Notes
`TableName`	`string`	`"walflow_state"`	valid DynamoDB table name	Table used for replication state
`Region`	`string?`	`null`	AWS region system name (for example `us-east-1`)	Optional when using service URL/default chain
`ServiceUrl`	`string?`	`null`	endpoint URL	For LocalStack or DynamoDB Local
`Authentication`	`AwsAuthenticationOptions`	`{}`	object	Preferred auth container
`Authentication.AccessKeyId`	`string?`	`null`	AWS access key id	Use with `Authentication.SecretAccessKey` for explicit credentials
`Authentication.SecretAccessKey`	`string?`	`null`	AWS secret access key	Use with `Authentication.AccessKeyId`
`Authentication.ProfileName`	`string?`	`null`	AWS shared profile name	Used when explicit keys are not set
`AutoCreateTable`	`bool`	`true`	`true`, `false`	Create table automatically when missing
`SlotKeyAttributeName`	`string`	`"slot_name"`	any valid DynamoDB attribute name	Partition key attribute
`StateJsonAttributeName`	`string`	`"state_json"`	any valid DynamoDB attribute name	JSON payload attribute
`UpdatedAtAttributeName`	`string`	`"updated_at"`	any valid DynamoDB attribute name	Updated timestamp attribute

AWS Authentication

The store supports all three auth methods:

Explicit credentials via Authentication.AccessKeyId + Authentication.SecretAccessKey
Shared profile via Authentication.ProfileName
Default AWS credential chain when no auth fields are set

Resolution order is: explicit keys → profile → default chain.

Example: profile-based auth

{
  "DynamoDbStore": {
    "TableName": "walflow_state",
    "Region": "us-east-1",
    "Authentication": {
      "ProfileName": "walflow-prod"
    }
  }
}

Example: default credentials

{
  "DynamoDbStore": {
    "TableName": "walflow_state",
    "Region": "us-east-1"
  }
}

Usage

services.Configure<DynamoDbStoreOptions>(
    configuration.GetSection(DynamoDbStoreOptions.SectionName));

services.AddSingleton<IReplicationStore, DynamoDbStore>();

Inline DI Registration

services.AddSingleton<IReplicationStore>(sp =>
{
    var options = Options.Create(new DynamoDbStoreOptions
    {
        TableName = "walflow_state",
        Region = "us-east-1",
        AutoCreateTable = true
    });

    return new DynamoDbStore(
        options,
        sp.GetRequiredService<ILogger<DynamoDbStore>>());
});

Notes

Supports region, profile, explicit credentials, and custom service URL.
AutoCreateTable can provision the table when missing.
Attribute names are configurable for integration with existing tables.

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.

net10.0
- AWSSDK.Core (>= 4.0.100.1)
- AWSSDK.DynamoDBv2 (>= 4.0.100.1)
- Microsoft.Extensions.DependencyInjection (>= 10.0.9)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Logging (>= 10.0.9)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Options (>= 10.0.9)
- WalFlow.Abstractions (>= 0.1.0-alpha.alpha.20260708090623)

NuGet packages (1)

Showing the top 1 NuGet packages that depend on WalFlow.Stores.DynamoDb:

Package	Downloads
WalFlow Meta-package that pulls in the full WalFlow CDC stack for consumers who want the default everything-included setup.	80

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
0.1.0-alpha.alpha...	90	7/8/2026
0.1.0-alpha.alpha...	87	3/30/2026