Merge branch 'release/3.1.0'

Author: lindyhopchris

CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file. This project adheres to
 [Semantic Versioning](http://semver.org/) and [this changelog format](http://keepachangelog.com/).
 
+## Unreleased
+
+## [3.1.0] - 2023-11-08
+
+### Changed
+
+- Encoding implementation no longer catches and re-throws exceptions when encoding compound document. Although the
+  implementation here was correct, we're getting far too many questions from developers who do not refer to the previous
+  exception even though the exception message specified that there was a previous exception.
+
 ## [3.0.1] - 2023-02-18
 
 ### Changed

src/Document.php

@@ -157,53 +157,33 @@ public function toString(): string
      */
     public function toArray()
     {
-        try {
-            return json_decode($this->toJson(), true, 512, JSON_THROW_ON_ERROR);
-        } catch (\Throwable $ex) {
-            throw new \LogicException(
-                'Unable to convert document to an array. See previous exception for cause of failure.',
-                0,
-                $ex,
-            );
-        }
+        return json_decode(
+            json: $this->toJson(),
+            associative: true,
+            flags: JSON_THROW_ON_ERROR,
+        );
     }
 
     /**
      * @inheritDoc
      */
     public function jsonSerialize(): array
     {
-        try {
-            $this->prepareEncoder();
-
-            return $this->serialize();
-        } catch (\Throwable $ex) {
-            throw new \LogicException(
-                'Unable to serialize compound document. See previous exception for cause of failure.',
-                0,
-                $ex,
-            );
-        }
+        $this->prepareEncoder();
+
+        return $this->serialize();
     }
 
     /**
      * @inheritDoc
      */
     public function toJson($options = 0)
     {
-        try {
-            $this->prepareEncoder();
-
-            $this->encoder->withEncodeOptions($options | JSON_THROW_ON_ERROR);
-
-            return $this->encode();
-        } catch (\Throwable $ex) {
-            throw new \LogicException(
-                'Unable to encode compound document. See previous exception for cause of failure.',
-                0,
-                $ex,
-            );
-        }
+        $this->prepareEncoder();
+
+        $this->encoder->withEncodeOptions($options | JSON_THROW_ON_ERROR);
+
+        return $this->encode();
     }
 
     /**