Mark other exception factories as internal

Author: alcaeus

src/Exception/BadMethodCallException.php

@@ -28,6 +28,7 @@ class BadMethodCallException extends BaseBadMethodCallException implements Excep
      *
      * @param string $class Class name
      * @return self
+     * @internal
      */
     public static function classIsImmutable(string $class)
     {
@@ -39,6 +40,7 @@ public static function classIsImmutable(string $class)
      *
      * @param string $method Method name
      * @return self
+     * @internal
      */
     public static function unacknowledgedWriteResultAccess(string $method)
     {

src/Exception/InvalidArgumentException.php

@@ -29,6 +29,7 @@
 
 class InvalidArgumentException extends DriverInvalidArgumentException implements Exception
 {
+    /** @internal */
     public static function cannotCombineCodecAndTypeMap(): self
     {
         return new self('Cannot provide both "codec" and "typeMap" options');
@@ -39,6 +40,7 @@ public static function cannotCombineCodecAndTypeMap(): self
      *
      * @param string $name  Name of the argument or option
      * @param mixed  $value Actual value (used to derive the type)
+     * @internal
      */
     public static function expectedDocumentType(string $name, mixed $value): self
     {
@@ -52,6 +54,7 @@ public static function expectedDocumentType(string $name, mixed $value): self
      * @param mixed               $value        Actual value (used to derive the type)
      * @param string|list<string> $expectedType Expected type as a string or an array containing one or more strings
      * @return self
+     * @internal
      */
     public static function invalidType(string $name, mixed $value, string|array $expectedType)
     {

src/Exception/ResumeTokenException.php

@@ -27,6 +27,7 @@ class ResumeTokenException extends RuntimeException
      *
      * @param mixed $value Actual value (used to derive the type)
      * @return self
+     * @internal
      */
     public static function invalidType(mixed $value)
     {
@@ -37,6 +38,7 @@ public static function invalidType(mixed $value)
      * Thrown when a resume token is not found in a change document.
      *
      * @return self
+     * @internal
      */
     public static function notFound()
     {

src/GridFS/Exception/CorruptFileException.php

@@ -25,6 +25,8 @@ class CorruptFileException extends RuntimeException
 {
     /**
      * Thrown when a chunk doesn't contain valid data.
+     *
+     * @internal
      */
     public static function invalidChunkData(int $chunkIndex): self
     {
@@ -36,6 +38,7 @@ public static function invalidChunkData(int $chunkIndex): self
      *
      * @param integer $expectedIndex Expected index number
      * @return self
+     * @internal
      */
     public static function missingChunk(int $expectedIndex)
     {
@@ -48,6 +51,7 @@ public static function missingChunk(int $expectedIndex)
      * @param integer $index         Actual index number (i.e. "n" field)
      * @param integer $expectedIndex Expected index number
      * @return self
+     * @internal
      */
     public static function unexpectedIndex(int $index, int $expectedIndex)
     {
@@ -60,6 +64,7 @@ public static function unexpectedIndex(int $index, int $expectedIndex)
      * @param integer $size         Actual size (i.e. "data" field length)
      * @param integer $expectedSize Expected size
      * @return self
+     * @internal
      */
     public static function unexpectedSize(int $size, int $expectedSize)
     {

src/GridFS/Exception/FileNotFoundException.php

@@ -29,6 +29,7 @@ class FileNotFoundException extends RuntimeException
      *
      * @param string $filename Filename
      * @return self
+     * @internal
      */
     public static function byFilename(string $filename)
     {
@@ -42,6 +43,7 @@ public static function byFilename(string $filename)
      * @param integer $revision  Revision
      * @param string  $namespace Namespace for the files collection
      * @return self
+     * @internal
      */
     public static function byFilenameAndRevision(string $filename, int $revision, string $namespace)
     {
@@ -54,6 +56,7 @@ public static function byFilenameAndRevision(string $filename, int $revision, st
      * @param mixed  $id        File ID
      * @param string $namespace Namespace for the files collection
      * @return self
+     * @internal
      */
     public static function byId(mixed $id, string $namespace)
     {

src/GridFS/Exception/StreamException.php

@@ -13,6 +13,7 @@ class StreamException extends RuntimeException
     /**
      * @param resource $source
      * @param resource $destination
+     * @internal
      */
     public static function downloadFromFilenameFailed(string $filename, $source, $destination): self
     {
@@ -25,6 +26,7 @@ public static function downloadFromFilenameFailed(string $filename, $source, $de
     /**
      * @param resource $source
      * @param resource $destination
+     * @internal
      */
     public static function downloadFromIdFailed(mixed $id, $source, $destination): self
     {
@@ -35,7 +37,10 @@ public static function downloadFromIdFailed(mixed $id, $source, $destination): s
         return new self(sprintf('Downloading file from "%s" to "%s" failed. GridFS identifier: "%s"', $sourceMetadata['uri'], $destinationMetadata['uri'], $idString));
     }
 
-    /** @param resource $source */
+    /**
+     * @param resource $source
+     * @internal
+     */
     public static function uploadFailed(string $filename, $source, string $destinationUri): self
     {
         $sourceMetadata = stream_get_meta_data($source);