fix(integration): use PR817 page traversal recovery

Author: vitormattos

src/Smalot/PdfParser/Pages.php

@@ -56,15 +56,11 @@ public function getPages(bool $deep = false): array
             return [];
         }
 
+        /** @var ElementArray $kidsElement */
         $kidsElement = $this->get('Kids');
-        if ($kidsElement instanceof ElementArray) {
-            $kids = $kidsElement->getContent();
-        } else {
-            $kids = [$kidsElement];
-        }
 
         if (!$deep) {
-            return $kids;
+            return $kidsElement->getContent();
         }
 
         // Prepare to apply the Pages' object's fonts to each page
@@ -73,6 +69,10 @@ public function getPages(bool $deep = false): array
         }
         $fontsAvailable = 0 < \count($this->fonts);
 
+        $kids = $kidsElement->getContent();
+        if (!\is_array($kids)) {
+            $kids = [];
+        }
         $pages = [];
 
         foreach ($kids as $kid) {
@@ -83,12 +83,70 @@ public function getPages(bool $deep = false): array
                     $kid->setFonts($this->fonts);
                 }
                 $pages[] = $kid;
+            } elseif ($kid instanceof PDFObject && $this->isRecoverablePageObject($kid)) {
+                $recoveredPage = new Page($kid->getDocument(), $kid->getHeader(), $kid->getContent(), $kid->getConfig());
+                if ($fontsAvailable) {
+                    $recoveredPage->setFonts($this->fonts);
+                }
+                $pages[] = $recoveredPage;
+            }
+        }
+
+        if ([] === $pages) {
+            $pages = $this->recoverPagesByParentReference($fontsAvailable);
+        }
+
+        return $pages;
+    }
+
+    /**
+     * Recover page objects when Kids is malformed but child objects still point
+     * to this node via Parent.
+     *
+     * @return array<Page>
+     */
+    protected function recoverPagesByParentReference(bool $fontsAvailable): array
+    {
+        $pages = [];
+
+        foreach ($this->getDocument()->getObjects() as $object) {
+            if ($object instanceof Page && $object->has('Parent') && $object->get('Parent') === $this) {
+                if ($fontsAvailable) {
+                    $object->setFonts($this->fonts);
+                }
+                $pages[] = $object;
+                continue;
+            }
+
+            if (!$object instanceof PDFObject || !$this->isRecoverablePageObject($object)) {
+                continue;
+            }
+
+            if ($object->get('Parent') !== $this) {
+                continue;
+            }
+
+            $recoveredPage = new Page($object->getDocument(), $object->getHeader(), $object->getContent(), $object->getConfig());
+            if ($fontsAvailable) {
+                $recoveredPage->setFonts($this->fonts);
             }
+            $pages[] = $recoveredPage;
         }
 
         return $pages;
     }
 
+    protected function isRecoverablePageObject(PDFObject $object): bool
+    {
+        // Some malformed files corrupt the key name for /Type and objects are not
+        // instantiated as Page. Recover only when page-specific keys are present.
+        if (!$object->has('Parent')) {
+            return false;
+        }
+
+        return $object->has('MediaBox') || $object->has('Contents');
+    }
+
     /**
      * Gathers information about fonts and collects them in a list.
      *