release 3.0.6

Author: AK47454453

RELEASE_NOTES.md

@@ -1282,4 +1282,95 @@
 | ➕ dodane    | 15            |
 | 🔧 zmienione | 22            |
 | ➖ usunięte  | 0             |
----
+---
+# Changelog zmian - `## 3.0.6 (2025-12-04)` - `API: 2.0.0 RC6.0`
+
+## 1. ksef-client
+
+### 1.1 api.builders
+- Dodano właściwość subjectDetails - "Dane podmiotu, któremu nadawane są uprawnienia" do wszystkich endpointów nadających uprawnienia **/permissions/.../grants. W RC6.0 pole jest opcjonalne; od 2025-12-19 będzie wymagane.)
+- **GrantEntityPermissionsRequestBuilder.java**: 🔧 dodanie pola `subjectDetails`
+- **GrantEUEntityPermissionsRequestBuilder.java**: 🔧 dodanie pól `subjectDetails` i `euEntityDetails`
+- **GrantEUEntityRepresentativePermissionsRequestBuilder.java**: 🔧 dodanie pola `subjectDetails`
+- **GrantIndirectEntityPermissionsRequestBuilder.java**: 🔧 dodanie pola `subjectDetails`
+- **GrantPersonPermissionsRequestBuilder.java**: 🔧 dodanie pola `subjectDetails`
+- **GrantAuthorizationPermissionsRequestBuilder.java**: 🔧 dodanie pola `subjectDetails`
+- **SubunitPermissionsGrantRequestBuilder.java**: 🔧 dodanie pola `subjectDetails`
+
+### 1.2 api.services
+- **DefaultCryptographyService.java**: 🔧 w `initCryptographyService` przechwycenie `SystemKSeFSDKException`
+- **DefaultVerificationLinkService.java**: 🔧 konstruktor z polem `KsefApiProperties` oznaczony jako deprecated, dodano nowy konstruktor z polem `String appUrl`
+
+### 1.3 api
+- **DefaultKsefClient.java**: 🔧 w metodzie `validResponse` dodano pomijanie parsowania jsona w przypadku odpowiedzi z API typów innych niż json,
+  - Dodano parametr `upoVersion` w metodach `openBatchSession` i `openOnlineSession`
+    - Pozwala wybrać wersję UPO (dostępne wartości: `"upo-v4-3"`)
+    - Ustawia nagłówek `X-KSeF-Feature` z odpowiednią wersją
+    - Domyślnie: v4-2, od 5.01.2026 → v4-3
+    - poprzednie wersje metod oznaczone jako deprecated
+- **HttpUtils.java**: 🔧 w metodzie `formatExceptionMessage` dodano dodatkowe sprawdzanie dla pustego body 
+
+### 1.4 client.interfaces
+- **KSeFClient.java**: 🔧 metody `openBatchSession` i `openOnlineSession` zgodnie z opisem w implementacji `DefaultKsefClient` 
+
+### 1.5 client.model
+- **auth/TokenPermissionType.java**: 🔧 dodano `PEPPOL_ID("PeppolId")`
+- **invoice/InitAsyncInvoicesQueryResponse.java**: 🔧 zmiana modyfikatora dostępu na prywatny dla pola `String referenceNumber`
+- **invoice/InvoiceExportPackage.java**: 🔧 dodanie opisów dla pól i dodanie pola `OffsetDateTime permanentStorageHwmDate`
+- **invoice/InvoiceQueryDateRange.java**: 🔧 dodanie pola `Boolean restrictToPermanentStorageHwmDate`
+- **invoice/InvoiceQueryFilters.java**: 🔧 poprawka w mapowaniu pola isSelfInvoicing (`@JsonProperty("isSelfInvoicing")`)
+- **invoice/QueryInvoiceMetadataResponse.java**: 🔧 dodanie pola `OffsetDateTime permanentStorageHwmDate`
+- Dodano właściwość subjectDetails - "Dane podmiotu, któremu nadawane są uprawnienia" do wszystkich endpointów nadających uprawnienia **/permissions/.../grants. W RC6.0 pole jest opcjonalne; od 2025-12-19 będzie wymagane.)
+- **permission/entity/GrantEntityPermissionsRequest.java**: 🔧 dodanie pola `subjectDetails`
+- **permission/euentity/EuEntityPermissionsGrantRequest.java**: 🔧 dodanie pól `subjectDetails`, `euEntityDetails` i podtypów 
+- **permission/euentity/GrantEUEntityRepresentativePermissionsRequest.java**: 🔧 dodanie pola `subjectDetails` i podtypów 
+- **permission/indirect/GrantIndirectEntityPermissionsRequest.java**: 🔧 dodanie pola `subjectDetails` i podtypów 
+- **permission/person/GrantPersonPermissionsRequest.java**: 🔧 dodanie pola `subjectDetails` i podtypów 
+- **permission/proxy/GrantAuthorizationPermissionsRequest.java**: 🔧 dodanie pola `subjectDetails` 
+- **permission/subunit/SubunitPermissionsGrantRequest.java**: 🔧 dodanie pola `subjectDetails` i podtypów 
+- **TestDataAttachmentRemoveRequest.java**: 🔧 dodanie pola `OffsetDateTime expectedEndDate` 
+- **TestDataPersonCreateRequest.java**: 🔧 dodanie pola `Boolean isDeceased` 
+- **ZipInputStreamWithSize.java**: ➕ dodanie nowego modelu
+- **StatusInfo.java**: 🔧 dodanie nowego pola `Map<String, String> extensions`
+
+### 1.6 client
+- **Headers.java**: 🔧 dodanie nowego pola `String X_KSEF_FEATURE = "X-KSeF-Feature"`
+
+### 1.7 system
+- **FilesUtil.java**: 🔧 przeniesione z modułu demo
+
+## 2. demo-web-app
+
+### 2.1 integrationTest
+- **BaseIntegrationTest.java**: 🔧 dodanie metody `AuthTokensPair authWithCustomPesel(String context, String pesel, EncryptionMethod encryptionMethod)`
+- **IntegrationConfig.java**: 🔧 przekazanie do ObjectMappera domyślnej wartości property `DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false`
+- **BatchIntegrationTest.java**: 🔧 kosmetyczne zmiany związane ze zmianą pakietów `FilesUtil.java`
+- **DuplicateInvoiceIntegrationTest.java**: ➕ dodanie nowego scenariusza testowego
+- **EnforcementOperationIntegrationTest.java**: ➕ dodanie nowego scenariusza testowego
+- **EnforcementOperationNegativeIntegrationTest.java**: ➕ dodanie nowego scenariusza testowego
+- **IncrementalInvoiceRetrieveIntegrationTest.java**: 🔧 aktualizacja scenariusza testowego
+- **PersonalPermissionAuthorizedPeselInNipContext.java**: ➕ dodanie nowego scenariusza testowego
+- **QueryInvoiceIntegrationTest.java**: 🔧 kosmetyczne zmiany związane ze zmianą pakietów `FilesUtil.java`
+- **SearchEntityInvoiceRoleIntegrationTest.java**: 🔧 poprawki w scenariuszu testowym
+- **SearchInvoiceForSubject2IntegrationTest.java**: 🔧 aktualizacja scenariusza testowego
+- **SearchInvoiceForSubject3IntegrationTest.java**: 🔧 aktualizacja scenariusza testowego
+- **SubUnitPermissionIntegrationTest.java**: 🔧 aktualizacja scenariusza testowego
+
+### 2.2 api
+- **ExampleApiProperties.java**: 🔧 zmiany w sposobie dostarczania konfiguracji w module demo `application.yaml`
+- **KsefClientConfig.java**: 🔧 wczytanie urla aplikacji z `application.yaml` do `DefaultVerificationLinkService`
+
+### 2.3 resources
+- **application.yaml**: 🔧 dodanie konfiguracji wymaganej w `ApiProperties.java`
+
+### 2.4 test - api.services
+- **ModelSerializationTest.java**: ➕ dodanie testu weryfikującego zgodność nazw pól/getterów/JsonProperty
+- **VerificationLinkServiceTests.java**: 🔧 aktualizacja testu
+
+## 3. Podsumowanie
+
+| Typ zmiany  | Liczba plików |
+|-------------|---------------|
+| ➕ dodane    | 34            |
+| 🔧 zmienione | 42            |
+| ➖ usunięte  | 0             |

demo-web-app/build.gradle.kts

@@ -8,7 +8,7 @@ plugins {
 }
 
 group = "pl.akmf.ksef"
-version = "3.0.5"
+version = "3.0.6"
 
 java {
     toolchain {
@@ -43,6 +43,7 @@ val wiremockStandaloneVersion = "3.9.1"
 val testcontainersVersion = "1.21.3"
 val awaitilityVersion = "4.2.0"
 val googleZxing = "3.5.3"
+val reflectionsVersion = "0.10.2"
 
 dependencies {
     implementation(project(":ksef-client"))
@@ -76,6 +77,8 @@ dependencies {
     integrationTestImplementation("org.testcontainers:testcontainers:${testcontainersVersion}")
     integrationTestImplementation("org.wiremock:wiremock-standalone:${wiremockStandaloneVersion}")
     implementation("org.awaitility:awaitility:${awaitilityVersion}")
+
+    testImplementation("org.reflections:reflections:${reflectionsVersion}")
 }
 
 sourceSets {

demo-web-app/src/integrationTest/java/pl/akmf/ksef/sdk/BatchIntegrationTest.java

@@ -22,8 +22,9 @@
 import pl.akmf.ksef.sdk.client.model.session.batch.BatchPartStreamSendingInfo;
 import pl.akmf.ksef.sdk.client.model.session.batch.OpenBatchSessionRequest;
 import pl.akmf.ksef.sdk.client.model.session.batch.OpenBatchSessionResponse;
+import pl.akmf.ksef.sdk.client.model.util.ZipInputStreamWithSize;
 import pl.akmf.ksef.sdk.configuration.BaseIntegrationTest;
-import pl.akmf.ksef.sdk.util.FilesUtil;
+import pl.akmf.ksef.sdk.system.FilesUtil;
 import pl.akmf.ksef.sdk.util.IdentifierGeneratorUtils;
 
 import java.io.ByteArrayOutputStream;
@@ -600,9 +601,9 @@ private String openBatchSessionAndSendInvoicesPartsStream(String context, String
 
         Map<String, byte[]> invoicesInMemory = FilesUtil.generateInvoicesInMemory(invoicesCount, context, invoice);
 
-        FilesUtil.ZipInputStreamWithSize zipInputStreamWithSize = FilesUtil.createZipInputStream(invoicesInMemory);
-        InputStream zipInputStream = zipInputStreamWithSize.byteArrayInputStream();
-        int zipLength = zipInputStreamWithSize.zipLength();
+        ZipInputStreamWithSize zipInputStreamWithSize = FilesUtil.createZipInputStream(invoicesInMemory);
+        InputStream zipInputStream = zipInputStreamWithSize.getInputStream();
+        int zipLength = zipInputStreamWithSize.getZipLength();
 
         // get ZIP metadata (before crypto)
         FileMetadata zipMetadata = defaultCryptographyService.getMetaData(zipInputStream);