HAKOM Namespace
The HAKOM namespace contains all types publicly available as an API. The library is divided into several modules, each serving a specific purpose.
For developers looking to work with time series, the single most important module is the TSM module. In fact, there is usually no need to explicitly reference any of the other modules directly.
Modules
Section titled “Modules”Contains all that is needed for time series management — the core domain model, persistence abstractions, calculation engine, and the HTTP API layer.
HAKOM.Configuration
Section titled “HAKOM.Configuration”Extensible configuration infrastructure supporting XML, JSON, environment variables, and command-line argument sources.
HAKOM.Console
Section titled “HAKOM.Console”Core console application abstractions built on Spectre.Console for HAKOM CLI tools.
HAKOM.Cryptography
Section titled “HAKOM.Cryptography”Certificate management, encryption and decryption services with support for file-system and local-user certificate stores.
The HAKOM dependency injection container, application context, and advanced factory registration system.
HAKOM.Documentation
Section titled “HAKOM.Documentation”HTTP-layer integration for API documentation, including OpenAPI/Swagger schema customisation.
HAKOM.ErrorHandling
Section titled “HAKOM.ErrorHandling”The foundation of the error handling infrastructure: the HakomException base class (with unique error codes and HTTP status mapping) and the Result/Result<T> types for non-throwing error propagation.
HAKOM.Http
Section titled “HAKOM.Http”Core HTTP service infrastructure — hosting, Kestrel configuration, CORS, compression, and request pipeline setup.
Interfaces and implementations for configuring logging in HAKOM applications, based on Microsoft.Extensions.Logging.
- HAKOM.Logging.Core — Bridges Microsoft.Extensions.Logging with the HAKOM dependency injection system. Includes a file-based logging provider.
- HAKOM.Logging.HakomDatabaseLog — Structured logging into relational databases via the legacy HAKOM Protokoll system, exposed as an
ILoggerProviderimplementation.
HAKOM.Persistence
Section titled “HAKOM.Persistence”Repository, store, and storage provider abstractions with concrete implementations for file systems, SQL databases (Oracle, PostgreSQL, SQL Server), and HTTP APIs.
HAKOM.Security
Section titled “HAKOM.Security”Authentication and authorisation infrastructure across core, HTTP, and persistence layers. Supports OpenID Connect, certificate-based, and Windows authentication.
HAKOM.Serialization
Section titled “HAKOM.Serialization”Media-type-aware serialisation framework supporting JSON, XML, and binary formats with content negotiation.
HAKOM.Versioning
Section titled “HAKOM.Versioning”Semantic versioning, assembly version introspection, and HTTP content negotiation based on API versions.