# Migrating the .NET library to version 6

> Breaking changes in the eKasa .NET library in version 6: unified namespaces, renamed and internal classes, NuGet package composition.

Source: https://ekasa.ninedigit.sk/en/docs/dotnet/migration-v6

This article is for integrators who use eKasa as a **.NET library** and are upgrading from version 5 to version 6.
Version 6 brought breaking changes: it unified the namespaces, renamed some classes and methods, made classes not
intended for public use internal and changed the composition of the NuGet packages.

## Overview of changes

- [Renamed classes and namespaces](#name-and-namespace-changes): 38 changes: merged namespaces, new names of classes, methods and exceptions.
- [Internal classes](#internal-classes): 55 classes and methods are no longer public (internal).
- [NuGet package composition](#nuget-package-composition): Separate packages for CHDÚ, one DLL instead of two.

## What to change

When upgrading to version 6, change in your code:

| What to change | Version 5 | Version 6 |
|---|---|---|
| `using` directives | `NineDigit.eKasa.Core.*`, `NineDigit.eKasa.Core.Data` | the single namespace `NineDigit.eKasa` |
| token class | `NineDigit.eKasa.Core.Printing.Models.Token` | `NineDigit.eKasa.PrintToken` |
| paths class | `NineDigit.eKasa.Helpers.EKasaPathHelper` | `NineDigit.eKasa.EKasaPath` |
| creating a certificate | `CertificateHelper.Create` | `Certificate.FromXml` |
| creating an identity | `IdentityHelper.Create` | `Identity.FromXml` |

The other renamed classes and methods are listed in the tables below.

## Name and namespace changes

All namespaces are unified into `NineDigit.eKasa`, so you no longer need several `using` directives.
All renamed classes and changed namespaces are listed in the tables below, grouped by kind of change.
The names reflect the state in version 6.

### Merged namespaces

Whole namespaces moved into `NineDigit.eKasa` or one of its sub-namespaces.

| Original namespace (v5) | New namespace (v6) |
|---|---|
| `NineDigit.eKasa.Core.Constants.PPEKK.*` | `NineDigit.eKasa.Constants.PPEKK.*` |
| `NineDigit.eKasa.Core.Data.*` | `NineDigit.eKasa` |
| `NineDigit.eKasa.Core.Data.Queries.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Data.Records.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Data.Validation.*` | `NineDigit.eKasa.Validation.*` |
| `NineDigit.eKasa.Core.Exceptions.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Extensions.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Printing.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Services.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Validation.*` | `NineDigit.eKasa.Validation.*` |

### Renamed and moved classes

These classes have a new name or a namespace of their own.

| Original name (v5) | New name (v6) |
|---|---|
| `NineDigit.eKasa.Core.Data.Helpers.TimeZoneHelper` | `NineDigit.eKasa.TimeZoneHelper` |
| `NineDigit.eKasa.Core.Data.ORPCodeEqualityComparer` | `NineDigit.eKasa.ORPCode.EqualityComparer` |
| `NineDigit.eKasa.Core.Helpers.DecimalHelper` | `NineDigit.eKasa.DecimalExtensions` |
| `NineDigit.eKasa.Core.Helpers.IAsyncLock` | `NineDigit.eKasa.Threading.IAsyncLock` |
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper` | `NineDigit.eKasa.SecureStringHelper` |
| `NineDigit.eKasa.Core.Helpers.ValidationHelper` | `NineDigit.eKasa.Validation.ValidationHelper` |
| `NineDigit.eKasa.Core.Helpers.WaitHandleHelper` | `NineDigit.eKasa.Threading.WaitHandleHelper` |
| `NineDigit.eKasa.Core.Printing.Models.Token` | `NineDigit.eKasa.PrintToken` |
| `NineDigit.eKasa.Core.Printing.PrinterNameEqualityComparer` | `NineDigit.eKasa.Printing.PrinterName.EqualityComparer` |
| `NineDigit.eKasa.Core.Resources.ValidationMessages` | `NineDigit.eKasa.Resources.ValidationMessages` |
| `NineDigit.eKasa.Core.Services.IStorageEnumerator` | `NineDigit.eKasa.Storage.IStorageEnumerator` |
| `NineDigit.eKasa.Core.Validation.Extensions.IValidatorExtensions` | `NineDigit.eKasa.Validation.IValidatorExtensions` |
| `NineDigit.eKasa.Core.Validation.Helpers.Validator` | `NineDigit.eKasa.Validation.Validator` |
| `NineDigit.eKasa.Helpers.EKasaPathHelper` | `NineDigit.eKasa.EKasaPath` |

### Replaced methods

The methods for working with a secure string (`SecureString`) and for creating a certificate and an identity have
new names.

| Original method (v5) | New method (v6) |
|---|---|
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper.Create(string)` | `NineDigit.eKasa.SecureStringHelper.FromString(string)` |
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper.Decrypt(SecureString)` | `NineDigit.eKasa.SecureStringHelper.ToString(SecureString)` |
| `NineDigit.eKasa.Factories.CertificateHelper.Create(Stream, SecureString)` | `NineDigit.eKasa.Certificate.FromXml(Stream, SecureString)` |
| `NineDigit.eKasa.Factories.CertificateHelper.Create(string, SecureString)` | `NineDigit.eKasa.Certificate.FromXml(string, SecureString)` |
| `NineDigit.eKasa.Factories.IdentityHelper.Create(Stream, bool)` | `NineDigit.eKasa.Identity.FromXml(Stream, bool)` |
| `NineDigit.eKasa.Factories.IdentityHelper.Create(string, bool)` | `NineDigit.eKasa.Identity.FromXml(string, bool)` |

### Exceptions

These exceptions have a new namespace.

| Original name (v5) | New name (v6) |
|---|---|
| `Microsoft.EntityFrameworkCore.ForeignKeyConstraintException` | `NineDigit.eKasa.ForeignKeyConstraintException` |
| `Microsoft.EntityFrameworkCore.UniqueConstraintException` | `NineDigit.eKasa.UniqueConstraintException` |
| `NineDigit.eKasa.Infrastructure.Storage.Verification.Exceptions.StorageVerificationException` | `NineDigit.eKasa.Storage.Verification.StorageVerificationException` |
| `NineDigit.eKasa.Storage.Indexing.Exceptions.IndexTableIntegrityException` | `NineDigit.eKasa.Storage.Indexing.IndexTableIntegrityException` |
| `NineDigit.eKasaClient.Exceptions.EKasaFaultException` | `NineDigit.eKasaClient.EKasaFaultException` |
| `NineDigit.eKasaClient.Exceptions.EKasaRegistrationException` | `NineDigit.eKasaClient.EKasaRegistrationException` |

### Types from the `System` namespace

| Original name (v5) | New name (v6) |
|---|---|
| `System.IDeepCloneable` | `NineDigit.eKasa.IDeepCloneable` |
| `System.IDeepCloneable<T>` | `NineDigit.eKasa.IDeepCloneable<T>` |

## Internal classes

Classes that are not intended for public use have the `internal` access modifier. The affected classes and methods
are listed below, grouped by their original namespace.

### `NineDigit.eKasa.Core.Services`

| Class or interface (v5) |
|---|
| `NineDigit.eKasa.Core.Services.DateTimeProvider` |
| `NineDigit.eKasa.Core.Services.EuropeBratislavaDateTimeProvider` |
| `NineDigit.eKasa.Core.Services.ICashDrawerService` |
| `NineDigit.eKasa.Core.Services.ICertificateRecordRepository` |
| `NineDigit.eKasa.Core.Services.IDateTimeProvider` |
| `NineDigit.eKasa.Core.Services.IIdentityRecordRepository` |
| `NineDigit.eKasa.Core.Services.IMemoryFileStreamer` |
| `NineDigit.eKasa.Core.Services.IPrinterStatusProvider` |
| `NineDigit.eKasa.Core.Services.IProductInfoProvider` |
| `NineDigit.eKasa.Core.Services.IReceiptNumberProvider` |
| `NineDigit.eKasa.Core.Services.IRecordRepository` |
| `NineDigit.eKasa.Core.Services.IRecordRepositoryConnection` |
| `NineDigit.eKasa.Core.Services.IRegisterTokenQueueProcessor` |
| `NineDigit.eKasa.Core.Services.ISwIdProvider` |
| `NineDigit.eKasa.Core.Services.MemoryRecordRepository` |
| `NineDigit.eKasa.Core.Services.OffsetStopwatch` |

### `NineDigit.eKasa.Core`

| Class, interface or method (v5) |
|---|
| `NineDigit.eKasa.Core.IEKasaClient` |
| `NineDigit.eKasa.Core.IEKasaClientRequest` |
| `NineDigit.eKasa.Core.IEKasaClientRequest<TResult>` |
| `NineDigit.eKasa.Core.IEKasaClientResponse` |
| `NineDigit.eKasa.Core.IEKasaClientResponse<TResult>` |
| `NineDigit.eKasa.Core.IEKasaClientResponseExtensions` |
| `NineDigit.eKasa.Core.IEKasaClientResponseExtensions.EnsureIsSuccessful(this IEKasaClientResponse)` |
| `NineDigit.eKasa.Core.IEKasaMessage` |
| `NineDigit.eKasa.Core.RegisterStateExtensions` |
| `NineDigit.eKasa.Core.X509Certificate2Extensions` |

### `NineDigit.eKasa.Core.Printing`

| Class or interface (v5) |
|---|
| `NineDigit.eKasa.Core.Printing.IPrinter` |
| `NineDigit.eKasa.Core.Printing.IPrinterProvider` |
| `NineDigit.eKasa.Core.Printing.NonfiscalReceiptPrintContext` |
| `NineDigit.eKasa.Core.Printing.ReceiptCopyPrintContext` |
| `NineDigit.eKasa.Core.Printing.ReceiptPrintContext` |
| `NineDigit.eKasa.Core.Printing.RequestsPrintContext` |

### `NineDigit.eKasa.Core.Helpers`

| Class or method (v5) |
|---|
| `NineDigit.eKasa.Core.Helpers.CryptoHelper` |
| `NineDigit.eKasa.Core.Helpers.DateTimeHelper` |
| `NineDigit.eKasa.Core.Helpers.DateTimeOffsetHelper` |
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper.Decrypt(SecureString, Action<string>)` |
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper.Decrypt<T>(SecureString, Action<string, T>)` |
| `NineDigit.eKasa.Core.Helpers.TimeoutHelper` |

### `NineDigit.eKasa.Core.Data` and `NineDigit.eKasa.Core.Extensions`

| Class or method (v5) |
|---|
| `NineDigit.eKasa.Core.Data.Comparers.ReferenceEqualityComparer` |
| `NineDigit.eKasa.Core.Data.Comparers.RegistrationRequestDataEqualityComparer` |
| `NineDigit.eKasa.Core.Data.RegisterReceiptResult.Create(ReceiptRegistrationRequest, IEKasaClientResponse<ReceiptRegistrationResult>)` |
| `NineDigit.eKasa.Core.Data.SubmitAsyncHandler(RegistrationRequest, CancellationToken)` |
| `NineDigit.eKasa.Core.Data.SubmitAsyncHandler<TRequest, TResult>(TRequest, CancellationToken)` |
| `NineDigit.eKasa.Core.Extensions.IInternetConnectivityMonitorExtensions` |
| `NineDigit.eKasa.Core.Extensions.ReceiptRegistrationRequestReceiptExtensions` |
| `NineDigit.eKasa.Core.Extensions.RegisterRequestStateExtensions` |

### Other namespaces

| Class, interface or method (v5) |
|---|
| `NineDigit.eKasa.Application.Domain.IReadOnlyRegisterTokenQueue` |
| `NineDigit.eKasa.Helpers.EKasaPathHelper.GetAbsoluteFilePath(string)` |
| `NineDigit.Validation.Extensions.IValidatableObjectExtensions` |
| `System.Net.WebRequestExtensions` |
| `System.ObjectExtensions` |
| `System.ObjectExtensions.ToInvariantString(this IFormattable, string)` |
| `System.Security.Cryptography.X509Certificates.X500DistinguishedNameExtensions` |
| `System.Security.Cryptography.X509Certificates.X509CertificateCollectionExtensions` |
| `System.TimeSpanExtensions` |

## NuGet package composition

| What | Change in version 6 |
|---|---|
| Libraries for accessing CHDÚ storages | `NineDigit.ChduTech` and `NineDigit.ChduLite` are separate NuGet packages. |
| `NineDigit.eKasa.Core.dll` | Merged into `NineDigit.eKasa.dll`. The `NineDigit.eKasa` NuGet package no longer contains two DLL files. |

## Next steps

- [Migration guides](https://ekasa.ninedigit.sk/en/docs/migration): Overview of changes between eKasa versions.
- [.NET Library](https://ekasa.ninedigit.sk/en/docs/dotnet): Requirements, NuGet packages and creating the client.
