Feature a Few Fixes

.gitignore

@@ -10,6 +10,7 @@ vendor
 node_modules
 .phpactor.json
 build
+.phpunit.cache
 
 ## Annotations
 src/DTO/Documents/AnnotationsStamps/*

README.md

@@ -315,6 +315,52 @@ $connector = new DocuWareConnector(
 );
 ```
 
+### Enums
+
+The package provides several enums to ensure type safety and consistency when working with DocuWare API values.
+
+#### ConnectionEnum
+
+Represents different connection types for DocuWare authentication:
+
+```php
+use CodebarAg\DocuWare\Enums\ConnectionEnum;
+
+ConnectionEnum::WITHOUT_COOKIE;    
+ConnectionEnum::STATIC_COOKIE; 
+ConnectionEnum::DYNAMIC_COOKIE;
+```
+
+#### DialogType
+
+Represents different types of dialogs in DocuWare:
+
+```php
+use CodebarAg\DocuWare\Enums\DialogType;
+
+DialogType::SEARCH; 
+DialogType::STORE;
+DialogType::RESULT;
+DialogType::INDEX; 
+DialogType::LIST; 
+DialogType::FOLDERS; 
+```
+
+#### DocuWareFieldTypeEnum
+
+Represents different field types used in DocuWare document indexing:
+
+```php
+use CodebarAg\DocuWare\Enums\DocuWareFieldTypeEnum;
+
+DocuWareFieldTypeEnum::STRING;
+DocuWareFieldTypeEnum::INT; 
+DocuWareFieldTypeEnum::DECIMAL;
+DocuWareFieldTypeEnum::DATE;
+DocuWareFieldTypeEnum::DATETIME;
+DocuWareFieldTypeEnum::TABLE;
+```
+
 ### Available Requests
 
 The following sections provide examples for each available request type. All functionality is documented inline below with code examples.

src/DTO/General/UserManagement/GetUsers/OutOfOffice.php

@@ -12,20 +12,24 @@ public static function fromJson(array $data): self
     {
         if ($startDateTime = Arr::get($data, 'StartDateTime')) {
             $startDateTime = Str::of($startDateTime)->after('(')->before(')');
-            $startDateTime = Carbon::createFromTimestamp($startDateTime);
+            // Extract milliseconds part (ignore optional timezone offset like +0000)
+            $milliseconds = (int) (string) $startDateTime;
+            $startDateTime = Carbon::createFromTimestampMs($milliseconds, 'UTC');
         }
 
         if ($endDateTime = Arr::get($data, 'EndDateTime')) {
             $endDateTime = Str::of($endDateTime)->after('(')->before(')');
-            $endDateTime = Carbon::createFromTimestamp($endDateTime);
+            // Extract milliseconds part (ignore optional timezone offset like +0000)
+            $milliseconds = (int) (string) $endDateTime;
+            $endDateTime = Carbon::createFromTimestampMs($milliseconds, 'UTC');
         }
 
         return new self(
             isOutOfOffice: Arr::get($data, 'IsOutOfOffice'),
             startDateTime: $startDateTime,
             startDateTimeSpecified: Arr::get($data, 'StartDateTimeSpecified'),
             endDateTime: $endDateTime,
-            endDateTimeSpecified: Arr::get($data, 'EndDateTimeSpecified'),
+            endDateTimeSpecified: Arr::get($data, key: 'EndDateTimeSpecified'),
         );
     }
 

src/Enums/DocuWareFieldTypeEnum.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace CodebarAg\DocuWare\Enums;
+
+enum DocuWareFieldTypeEnum: string
+{
+    case STRING = 'String';
+    case INT = 'Int';
+    case DECIMAL = 'Decimal';
+    case DATE = 'Date';
+    case DATETIME = 'DateTime';
+    case TABLE = 'Table';
+}

tests/Unit/Enums/ConnectionEnumTest.php

@@ -0,0 +1,37 @@
+<?php
+
+use CodebarAg\DocuWare\Enums\ConnectionEnum;
+
+it('has all expected connection enum cases', function () {
+    $expectedCases = [
+        'WITHOUT_COOKIE',
+        'STATIC_COOKIE',
+        'DYNAMIC_COOKIE',
+    ];
+
+    $actualCases = array_map(fn ($case) => $case->value, ConnectionEnum::cases());
+
+    expect($actualCases)->toBe($expectedCases);
+});
+
+it('can get string value from enum', function () {
+    expect(ConnectionEnum::WITHOUT_COOKIE->value)->toBe('WITHOUT_COOKIE');
+    expect(ConnectionEnum::STATIC_COOKIE->value)->toBe('STATIC_COOKIE');
+    expect(ConnectionEnum::DYNAMIC_COOKIE->value)->toBe('DYNAMIC_COOKIE');
+});
+
+it('can create enum from string value', function () {
+    expect(ConnectionEnum::from('WITHOUT_COOKIE'))->toBe(ConnectionEnum::WITHOUT_COOKIE);
+    expect(ConnectionEnum::from('STATIC_COOKIE'))->toBe(ConnectionEnum::STATIC_COOKIE);
+    expect(ConnectionEnum::from('DYNAMIC_COOKIE'))->toBe(ConnectionEnum::DYNAMIC_COOKIE);
+});
+
+it('throws exception for invalid enum value', function () {
+    expect(fn () => ConnectionEnum::from('INVALID_VALUE'))
+        ->toThrow(ValueError::class);
+});
+
+it('can try to create enum from string value', function () {
+    expect(ConnectionEnum::tryFrom('WITHOUT_COOKIE'))->toBe(ConnectionEnum::WITHOUT_COOKIE);
+    expect(ConnectionEnum::tryFrom('INVALID_VALUE'))->toBeNull();
+});