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

@@ -10,14 +10,22 @@ final class OutOfOffice
 {
     public static function fromJson(array $data): self
     {
-        if ($startDateTime = Arr::get($data, 'StartDateTime')) {
+        $startDateTime = Arr::get($data, 'StartDateTime');
+
+        $timeZone = config('app.timezone', 'UTC');
+
+        if (filled($startDateTime)) {
             $startDateTime = Str::of($startDateTime)->after('(')->before(')');
-            $startDateTime = Carbon::createFromTimestamp($startDateTime);
+            $milliseconds = (int) (string) $startDateTime;
+            $startDateTime = Carbon::createFromTimestampMs($milliseconds, $timeZone);
         }
 
-        if ($endDateTime = Arr::get($data, 'EndDateTime')) {
+        $endDateTime = Arr::get($data, 'EndDateTime');
+
+        if (filled($endDateTime)) {
             $endDateTime = Str::of($endDateTime)->after('(')->before(')');
-            $endDateTime = Carbon::createFromTimestamp($endDateTime);
+            $milliseconds = (int) (string) $endDateTime;
+            $endDateTime = Carbon::createFromTimestampMs($milliseconds, $timeZone);
         }
 
         return new self(

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';
+}