Skip to content
CAI
Software that uses CAICheck a score

kurrent-io/KurrentDB-Client-Dotnet

50.0

Adequate · 8 November 2026

13.7k

lines of production code

C#

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add KurrentDB client reading events sample

A new C\# sample program has been added to demonstrate how to read events using the KurrentDB client. The code illustrates connecting via a connection string, appending events to a stream, and reading from specific streams in both forward and backward directions. It also covers reading from the global all-stream and handling stream messages to manage positions and detect stream states.

samples/reading-events · high confidence

Add KurrentDB server-side filtering sample

The server-side-filtering sample now demonstrates the KurrentDB client, showing how to subscribe to all events with filters for event type prefixes, regex patterns, stream prefixes, and regex patterns, as well as how to exclude system events and handle checkpoints.

samples/server-side-filtering · high confidence

Add persistent subscription usage samples for KurrentDB

The samples/persistent-subscriptions directory now includes a Program.cs file demonstrating how to use the KurrentDB client for persistent subscriptions. The sample covers creating, updating, and deleting subscriptions to both specific streams and the global stream, as well as connecting to these subscriptions to process events. It illustrates both automatic acknowledgment (where the client handles acks) and manual acknowledgment modes, including handling unrecoverable errors by parking events. The sample also shows how to retrieve subscription info, list existing subscriptions, and replay parked events.

samples/persistent-subscriptions · high confidence

Added projection management sample application

A new sample application has been added to demonstrate the KurrentDB projection management features. This .NET console app connects to a local KurrentDB instance and exercises the full lifecycle of projection management, including creating, enabling, disabling, aborting, resetting, and listing continuous projections, as well as handling not-found scenarios.

samples/projection-management · high confidence

Initial release of the KurrentDB .NET Client

This change introduces the KurrentDB .NET Client SDK, establishing the foundational project structure and configuration. It sets up the solution with multi-targeting for .NET Framework 4.8, .NET 8.0, .NET 9.0, and .NET 10.0, and enables C\# nullable reference types and implicit usings. The repository is initialized with standard development tooling, including an EditorConfig for code formatting, .gitattributes for line-ending normalization, and a .gitignore, alongside the Apache 2.0 license and initial documentation.

(repo-wide) · high confidence

Initial release of the KurrentDB .NET client library

This change introduces the KurrentDB .NET client, providing the core infrastructure for connecting to and interacting with a KurrentDB cluster. The library includes gRPC channel management with support for both single-node and cluster topologies, TLS certificate handling (including PEM file loading), and comprehensive OpenTelemetry tracing for client operations. It also provides shims for modern C\# features (like Index/Range) to ensure compatibility with older .NET Framework versions.

src/KurrentDB.Client · high confidence

Introduce structured diagnostics, server capability detection, and persistent subscription details

The KurrentDB.Client library now includes foundational support for distributed tracing via new \ActivityStatus\ and \TracingMetadata\ types that integrate with .NET's \System.Diagnostics\. It adds a \ServerCapabilities\ record to detect server-side feature support (such as multi-stream append and batch operations) and version-specific behaviors like subscription fell-behind notifications. Additionally, the client exposes detailed persistent subscription management through new \PersistentSubscriptionInfo\, \PersistentSubscriptionStats\, and \PersistentSubscriptionConnectionInfo\ records, allowing users to inspect subscription status, connection details, and live statistics.

KurrentDB.Client · high confidence

New .NET 8 quick-start sample for KurrentDB

A new quick-start sample has been added for the KurrentDB client, demonstrating core event-streaming operations in .NET 8. The sample includes a Docker Compose configuration to spin up a local EventStore instance and a C\# program that illustrates how to create a client using a connection string, write events to a stream, read events back, and override user credentials for specific operations.

samples/quick-start · high confidence

New .NET TLS-secured client sample with automated certificate generation

This location introduces a new sample demonstrating how to connect a .NET client to EventStoreDB using gRPC with TLS. The sample includes a Dockerfile (based on .NET 8.0) that installs the CA certificate into the container's trust store, and a Program.cs that uses the KurrentDB client to append events over a secure connection. It provides a complete local development workflow via docker-compose files: docker-compose.certs.yml uses the es-gencert-cli to generate self-signed CA and node certificates, while helper scripts (create-certs.sh, create-certs.ps1) automate certificate generation and installation on the host machine for local testing.

samples/secure-with-tls · high confidence

New KurrentDB diagnostics sample with OpenTelemetry tracing

A new sample application in the diagnostics folder demonstrates how to integrate the KurrentDB client with OpenTelemetry for distributed tracing. The sample configures a .NET host to create an ActivitySource, registers the KurrentDB client instrumentation via AddKurrentDBClientInstrumentation, and sets up trace exporters to console and Jaeger, allowing users to observe trace data generated during stream append operations.

samples/diagnostics · high confidence

New sample demonstrating KurrentDB client event appending operations

The 'samples/appending-events' directory now contains a new Program.cs file that serves as a comprehensive guide for using the KurrentDB .NET client. This sample demonstrates various event appending patterns, including single and multi-stream appends, operations with consistency checks (such as verifying stream state before writing), and handling concurrency scenarios like duplicate event detection and no-stream validation. It replaces the previous 'Writing events' sample to align with the new 'Appending events' naming convention.

samples/appending-events · high confidence

New sample demonstrating KurrentDB stream subscriptions

Added a new sample application in the \samples/subscribing-to-streams\ directory that illustrates how to use the KurrentDB client to subscribe to individual streams and the global all-stream. The code demonstrates various subscription modes, including subscribing from a specific position, subscribing to live events, resolving link-tos, handling dropped subscriptions with checkpointing, and overriding user credentials.

samples/subscribing-to-streams · high confidence

New sample demonstrating dependency injection with KurrentDB

A new sample project has been added to the \samples/setting-up-dependency-injection\ location to illustrate how to integrate the KurrentDB client into an ASP.NET Core application using dependency injection. The sample includes a \Startup\ class that registers the \KurrentDBClient\ via a connection string (\esdb://...\) and an \EventStoreController\ that consumes the client through constructor injection to read events. This provides a concrete reference for wiring the client library within a standard web host lifecycle.

samples/setting-up-dependency-injection · high confidence

Removals

Removal of gRPC test infrastructure components

The shared test utilities for the gRPC module have been removed, including the \EventStoreGrpcFixture\ base class, \TestVNodeBuilder\, \TestCredentials\, and related helper classes. This eliminates the previous mechanism for spinning up in-memory gRPC test servers and managing test-specific node configurations and credentials within this library.

src/EventStore.Grpc.Tests.Common · high confidence

Removal of legacy gRPC client implementation

The legacy \EventStoreGrpcClient\ and its associated types (including \AnyStreamRevision\, \StreamRevision\, \EventData\, \EventRecord\, and filter structs) have been removed from the \src/EventStore.Grpc\ directory. This deletion eliminates the previous client API surface, indicating a shift to a new client implementation or protocol version.

src/EventStore.Grpc · high confidence

Removal of legacy gRPC proto definitions

The legacy gRPC protocol buffer definitions for persistent subscriptions (\persistent.proto\) and stream operations (\streams.proto\) have been removed from the \src/Protos/Grpc\ directory. This change eliminates the old service contracts and message types (such as \PersistentSubscriptions\ and \Streams\ services) that were previously defined in these files, indicating a migration away from these specific proto-based interfaces.

src/Protos · high confidence

Behavioural changes

Samples rebranded to KurrentDB with .NET 8/9 support and new security examples

The samples directory has been rebranded from EventStore to KurrentDB, updating the solution and project references to use the KurrentDB.Client library. The sample projects now target .NET 8.0 and .NET 9.0, enabling nullable reference types and implicit usings for a modern development experience. New samples have been added to demonstrate secure connections using user certificates (TLS with client authentication) and persistent subscriptions, alongside existing examples for appending, reading, and subscribing to events.

samples · high confidence

Updated connection samples to use KurrentDB client and connection strings

The samples in the connecting-to-a-single-node and connecting-to-a-cluster directories have been updated to use the KurrentDB.Client library instead of the previous EventStoreDB client. The code now demonstrates connecting via connection strings (using both 'kurrentdb://' and 'esdb://' schemes) and includes examples for configuring interceptors and custom HTTP message handlers.

samples/connecting-to-a-single-node · high confidence

Test coverage

1 commit adding/updating tests in test/KurrentDB.Client.Tests/Streams/AppendRecords; 4 commits adding/updating tests in test/KurrentDB.Client.Tests/UserManagement; 5 commits adding/updating tests in test/KurrentDB.Client.Tests/Streams/Read; Added idiomatic assertions and test helper assemblies for client-side type validation; Added integration tests for KurrentDB Client operations and security; Added tests for KurrentDB Client Streams operations; Added tests for KurrentDB Client persistent subscriptions; Added tests for projection management operations; Added tracing instrumentation tests for client operations; Initial test suite for KurrentDB Client; New test infrastructure and utilities for KurrentDB Client; Removal of gRPC Persistent Subscriptions test suite; Removed obsolete gRPC test suite.

Dependencies

Introduce KurrentDB.Client and modernize documentation build tooling

This change introduces the new \KurrentDB.Client\ project, a GRPC-based client library for the Kurrent Platform, replacing the legacy \EventStore.Grpc\ project. The new client targets .NET 8.0 and .NET Framework 4.8, utilizing modern dependencies such as \Grpc.Net.Client\ 2.67.0, \Google.Protobuf\ 3.32.1, and \OpenTelemetry.Api\ 1.15.3. To support this, numerous sample projects (e.g., \quick-start\, \persistent-subscriptions\) have been added or updated to reference the new client, and legacy EventStore GRPC test projects have been removed. Additionally, the documentation build system has been migrated to a Node.js environment using VuePress 2.0.0-rc.19, Vite, and Vue 3, with a new \docs/package.json\ and \pnpm-lock.yaml\ defining the tooling stack.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 46 → 50 (+4.1)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 74 → 74 (+0.0)
  • Architecture 78 → 68 (-9.9)
  • Maturity 27 → 41 (+13.7)
  • Readiness 54 → 48 (-6.2)
  • Security 65 → 62 (-3.4)
  • Performance 70 → 76 (+6.4)

Resolved (104)

  • Change coupling: ChannelFactory.cs ↔ KurrentDBClientConnectivitySettings.cs (src/KurrentDB.Client/Core/ChannelFactory.cs)
  • Coverage not measured — no coverage collector is wired up
  • Duplicate Filter Types with Identical Signatures
  • Inconsistent Verbosity in Replay Methods
  • Low XML-doc coverage: connecting-to-a-single-node(net8.0) (samples/connecting-to-a-single-node/connecting-to-a-single-node.csproj)
  • Low XML-doc coverage: projection-management(net8.0) (samples/projection-management/projection-management.csproj)
  • Low XML-doc coverage: quick-start(net8.0) (samples/quick-start/quick-start.csproj)
  • Low XML-doc coverage: setting-up-dependency-injection(net8.0) (samples/setting-up-dependency-injection/setting-up-dependency-injection.csproj)
  • Low cohesion: KurrentDBClient (LCOM4 4) (src/KurrentDB.Client/Streams/KurrentDBClient.cs)
  • No assertions: acl_inheritance_is_working_properly_on_system_streams_when_not_authenticated (test/KurrentDB.Client.Tests/Security/StreamSecurityInheritanceTests.cs)
  • No assertions: acl_inheritance_is_working_properly_on_user_streams_when_not_authenticated (test/KurrentDB.Client.Tests/Security/StreamSecurityInheritanceTests.cs)
  • No assertions: deleting_normal_admin_stream_with_admin_user_is_allowed (test/KurrentDB.Client.Tests/Security/DeleteStreamSecurityTests.cs)
  • No assertions: deleting_normal_all_stream_with_admin_user_is_allowed (test/KurrentDB.Client.Tests/Security/DeleteStreamSecurityTests.cs)
  • No assertions: deleting_normal_all_stream_with_existing_user_is_allowed (test/KurrentDB.Client.Tests/Security/DeleteStreamSecurityTests.cs)
  • No assertions: deleting_normal_all_stream_with_no_user_is_allowed (test/KurrentDB.Client.Tests/Security/DeleteStreamSecurityTests.cs)
  • No assertions: deleting_normal_no_acl_stream_with_admin_user_is_allowed (test/KurrentDB.Client.Tests/Security/DeleteStreamSecurityTests.cs)
  • No assertions: deleting_normal_no_acl_stream_with_existing_user_is_allowed (test/KurrentDB.Client.Tests/Security/DeleteStreamSecurityTests.cs)
  • No assertions: deleting_normal_no_acl_stream_with_no_user_is_allowed (test/KurrentDB.Client.Tests/Security/DeleteStreamSecurityTests.cs)
  • No assertions: deleting_normal_user_stream_with_admin_user_is_allowed (test/KurrentDB.Client.Tests/Security/DeleteStreamSecurityTests.cs)
  • No assertions: deleting_normal_user_stream_with_authorized_user_is_allowed (test/KurrentDB.Client.Tests/Security/DeleteStreamSecurityTests.cs)
  • …and 84 more

New (21)

  • Documentation: no build, run or usage example (README.md)
  • Off-boarding risk: anonymized user #1
  • Off-boarding risk: anonymized user #2
  • Projects may be oversized for their cohesion (src/KurrentDB.Client/KurrentDB.Client.csproj)
  • StreamSubscription.Subscribe (cognitive 16) (src/KurrentDB.Client/Streams/StreamSubscription.cs)
  • doc comments repeat the names (src/KurrentDB.Client/Core/EventRecord.cs)
  • doc comments repeat the names (test/KurrentDB.Client.Tests.Common/InterlockedBoolean.cs)
  • redundant comment (docs/.vuepress/markdown/xode/createImportCodeBlockRule.ts)
  • redundant comment (docs/.vuepress/markdown/xode/importCodePlugin.ts)
  • redundant comment (docs/.vuepress/markdown/xode/importCodePlugin.ts)
  • redundant comment (docs/.vuepress/markdown/xode/resolveImportCode.ts)
  • top-level statements (cognitive 18) (samples/projection-management/Program.cs)
  • top-level statements (cognitive 19) (samples/persistent-subscriptions/Program.cs)
  • top-level statements (cognitive 25) (samples/reading-events/Program.cs)
  • top-level statements (cognitive 27) (samples/server-side-filtering/Program.cs)
  • top-level statements (cognitive 43) (samples/subscribing-to-streams/Program.cs)
  • top-level statements (cyclomatic 18) (samples/persistent-subscriptions/Program.cs)
  • top-level statements (cyclomatic 19) (samples/projection-management/Program.cs)
  • top-level statements (cyclomatic 22) (samples/server-side-filtering/Program.cs)
  • top-level statements (cyclomatic 29) (samples/reading-events/Program.cs)
  • …and 1 more

Changes since last survey

  • 1 commits — 0 feature/other, 1 fixes

By area

  • src/KurrentDB.Client — 1 commit

Notable commits

  • fix: Fix caller token registration leak in read and subscription results (#431)

API surface

  • Unchanged — 1 HTTP endpoints

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

kurrent-io/KurrentDB-Client-Dotnet was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 8 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit bb00b9cfc0a6e5b289fc923801466dd9335b5468 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-45ab2cab63de.