refactor: removes need for final DTOs

Author: JasonTheAdams

src/Common/Contracts/WithArrayTransformationInterface.php

@@ -28,7 +28,7 @@ public function toArray(): array;
      * @since 1.0.0
      *
      * @param TArrayShape $array The array data.
-     * @return static The created instance.
+     * @return self<TArrayShape> The created instance.
      */
-    public static function fromArray(array $array);
+    public static function fromArray(array $array): self;
 }

src/Files/DTO/File.php

@@ -27,7 +27,7 @@
  *
  * @extends AbstractDataValueObject<FileArrayShape>
  */
-final class File extends AbstractDataValueObject
+class File extends AbstractDataValueObject
 {
     public const KEY_FILE_TYPE = 'fileType';
     public const KEY_MIME_TYPE = 'mimeType';
@@ -425,7 +425,7 @@ public function toArray(): array
      *
      * @since n.e.x.t
      */
-    public static function fromArray(array $array): File
+    public static function fromArray(array $array): self
     {
         static::validateFromArrayData($array, [self::KEY_FILE_TYPE]);
 

src/Messages/DTO/Message.php

@@ -125,9 +125,9 @@ public function toArray(): array
      *
      * @since n.e.x.t
      *
-     * @return Message The specific message class based on the role.
+     * @return self The specific message class based on the role.
      */
-    final public static function fromArray(array $array): Message
+    final public static function fromArray(array $array): self
     {
         static::validateFromArrayData($array, [self::KEY_ROLE, self::KEY_PARTS]);
 

src/Messages/DTO/MessagePart.php

@@ -34,7 +34,7 @@
  *
  * @extends AbstractDataValueObject<MessagePartArrayShape>
  */
-final class MessagePart extends AbstractDataValueObject
+class MessagePart extends AbstractDataValueObject
 {
     public const KEY_TYPE = 'type';
     public const KEY_TEXT = 'text';
@@ -258,7 +258,7 @@ public function toArray(): array
      *
      * @since n.e.x.t
      */
-    public static function fromArray(array $array): MessagePart
+    public static function fromArray(array $array): self
     {
         static::validateFromArrayData($array, [self::KEY_TYPE]);
 

src/Messages/DTO/ModelMessage.php

@@ -15,7 +15,7 @@
  *
  * @since n.e.x.t
  */
-final class ModelMessage extends Message
+class ModelMessage extends Message
 {
     /**
      * Constructor.

src/Messages/DTO/SystemMessage.php

@@ -15,7 +15,7 @@
  *
  * @since n.e.x.t
  */
-final class SystemMessage extends Message
+class SystemMessage extends Message
 {
     /**
      * Constructor.

src/Messages/DTO/UserMessage.php

@@ -14,7 +14,7 @@
  *
  * @since n.e.x.t
  */
-final class UserMessage extends Message
+class UserMessage extends Message
 {
     /**
      * Constructor.

src/Operations/DTO/GenerativeAiOperation.php

@@ -24,7 +24,7 @@
  *
  * @extends AbstractDataValueObject<GenerativeAiOperationArrayShape>
  */
-final class GenerativeAiOperation extends AbstractDataValueObject implements OperationInterface
+class GenerativeAiOperation extends AbstractDataValueObject implements OperationInterface
 {
     public const KEY_ID = 'id';
     public const KEY_STATE = 'state';
@@ -170,7 +170,7 @@ public function toArray(): array
      *
      * @since n.e.x.t
      */
-    public static function fromArray(array $array): GenerativeAiOperation
+    public static function fromArray(array $array): self
     {
         static::validateFromArrayData($array, [self::KEY_ID, self::KEY_STATE]);
 

src/Results/DTO/Candidate.php

@@ -22,7 +22,7 @@
  *
  * @extends AbstractDataValueObject<CandidateArrayShape>
  */
-final class Candidate extends AbstractDataValueObject
+class Candidate extends AbstractDataValueObject
 {
     public const KEY_MESSAGE = 'message';
     public const KEY_FINISH_REASON = 'finishReason';
@@ -146,7 +146,7 @@ public function toArray(): array
      *
      * @since n.e.x.t
      */
-    public static function fromArray(array $array): Candidate
+    public static function fromArray(array $array): self
     {
         static::validateFromArrayData($array, [self::KEY_MESSAGE, self::KEY_FINISH_REASON, self::KEY_TOKEN_COUNT]);
 

src/Results/DTO/GenerativeAiResult.php

@@ -29,7 +29,7 @@
  *
  * @extends AbstractDataValueObject<GenerativeAiResultArrayShape>
  */
-final class GenerativeAiResult extends AbstractDataValueObject implements ResultInterface
+class GenerativeAiResult extends AbstractDataValueObject implements ResultInterface
 {
     public const KEY_ID = 'id';
     public const KEY_CANDIDATES = 'candidates';
@@ -417,7 +417,7 @@ public function toArray(): array
      *
      * @since n.e.x.t
      */
-    public static function fromArray(array $array): GenerativeAiResult
+    public static function fromArray(array $array): self
     {
         static::validateFromArrayData($array, [self::KEY_ID, self::KEY_CANDIDATES, self::KEY_TOKEN_USAGE]);