Kanject Core — Library Reference

View .md

Kanject Core is a suite of focused .NET libraries for building production services on AWS in clean, testable C#. Eighteen libraries — the Community ones on public NuGet, the rest on the private feed — wired up through extension methods on IServiceCollection.

Pick the libraries you need — they're independent and tree-shakeable, wired à-la-carte. Each library has its own page below.

Your first working example

Start with the Orders API tutorial. You will create a small .NET API, connect it to DynamoDB Local, and read the same sample orders in C# and DynoStudio. It includes a downloadable project, package versions, file locations, and expected results. You need the .NET 10 SDK, access to the private DynamoDB packages, and the local dataset setup.

Already integrating a library? Choose its reference below for installation and configuration details. Start with one library; add others as your service needs them.

Persistence & data

NoSqlDatabase
Type-safe NoSQL across DynamoDB, ScyllaDB, and Amazon Keyspaces — one [Repository] shape, three engines.
SqlDatabase
Relational sibling with an Aurora DSQL provider (v1.0.0). Same [Repository] ergonomics as NoSqlDatabase.
CacheDb
Cache over DynamoDB, S3 Express, or in-memory — typed values, absolute expiry, namespaced keys.
FileRepository
S3 wrapper with content-type detection, presigned URLs, access levels.

Messaging & events

Queue
SQS — IQueueManager producer, [QueueConsumer] batch handlers, retries, automatic DLQ.
Channels
One [Channel] handler, two hosts — a batching drain loop that runs as a BackgroundService or inside a Lambda invocation.
Events
[EventTopic] + IEventPublisher — in-process handlers by default, SNS or your own broker when the host registers one.
ChangeFeed
DynamoDB row changes become published events, drained in order from the stream — plus a transactional outbox.
CloudFunction
[CloudFunctionHost] source-generated Lambda host — DI, config source, cold-start reuse.

Web & API

Api
ASP.NET Core baseline — Response<T> envelope, exception middleware, x-tenant-id resolution, and source-generated minimal-API endpoints.
Adapter
Typed adapters for outbound HTTP APIs — auth, retries, source-generated endpoints.
Qr
First-party QR encoder — styled SVG/PNG, logo overlays, scannability verifier. AOT-clean.

Operations & background work

Logs
A queryable, DynamoDB-backed log store — write records into named groups, read by text and time.
Recurring
[Recurring(rate, unit)] on a method → a generated, drift-corrected recurring runner.
Parallel
[Parallel] on a method → generated bounded fan-out with chunking, retries, timeouts, and per-item outcomes for partial batches.
EtlTaskManager
In-process Extract → Transform → Load for bounded imports and migrations.

Composition & editions

Packages
The strategy pattern, generated — tag a class as a provider and the resolver, manager, and keyed DI are written for you.
Features
[LockedBehind] edition locks decide what ships; IFeatureGate decides what runs.

Pattern

Every Core library follows the same shape: Add<Service>() extension methods on IServiceCollection, attribute-driven configuration, and an interface you can mock for tests. Once you've learned one, you've learned them all.

Was this page helpful?