PHPLIB-953 Make internal classes and Operation classes final (#1392)

* PHPLIB-953 Make internal classes final

* Make all Operation classes final

* Add UPGRADE-2.0

Author: GromNaN

UPGRADE-2.0.md

@@ -36,7 +36,7 @@
  * @internal
  * @see https://mongodb.com/docs/manual/reference/command/listCollections/
  */
-class ListCollections implements Executable
+final class ListCollections implements Executable
 {
     /**
      * Constructs a listCollections command.

src/Command/ListCollections.php

@@ -37,7 +37,7 @@
  * @internal
  * @see https://mongodb.com/docs/manual/reference/command/listDatabases/
  */
-class ListDatabases implements Executable
+final class ListDatabases implements Executable
 {
     /**
      * Constructs a listDatabases command.

src/Command/ListDatabases.php

@@ -39,7 +39,7 @@
  *
  * @internal
  */
-class CollectionWrapper
+final class CollectionWrapper
 {
     private Collection $chunksCollection;
 

src/GridFS/CollectionWrapper.php

@@ -38,7 +38,7 @@
  *
  * @internal
  */
-class ReadableStream
+final class ReadableStream
 {
     private ?string $buffer = null;
 

src/GridFS/ReadableStream.php

@@ -49,7 +49,7 @@
  * @see Bucket::openDownloadStream()
  * @psalm-type ContextOptions = array{collectionWrapper: CollectionWrapper, file: object}|array{collectionWrapper: CollectionWrapper, filename: string, options: array}
  */
-class StreamWrapper
+final class StreamWrapper
 {
     /** @var resource|null Stream context (set by PHP) */
     public $context;
@@ -89,7 +89,7 @@ public static function register(string $protocol = 'gridfs'): void
             stream_wrapper_unregister($protocol);
         }
 
-        stream_wrapper_register($protocol, static::class, STREAM_IS_URL);
+        stream_wrapper_register($protocol, self::class, STREAM_IS_URL);
     }
 
     /**

src/GridFS/StreamWrapper.php

@@ -35,7 +35,7 @@
  *
  * @internal
  */
-class WritableStream
+final class WritableStream
 {
     private const DEFAULT_CHUNK_SIZE_BYTES = 261120;
 

src/GridFS/WritableStream.php

@@ -40,7 +40,7 @@
  * @template TValue
  * @template-implements Iterator<TKey, TValue>
  */
-class CachingIterator implements Countable, Iterator
+final class CachingIterator implements Countable, Iterator
 {
     private const FIELD_KEY = 0;
     private const FIELD_VALUE = 1;

src/Model/CachingIterator.php

@@ -34,7 +34,7 @@
  * @template TCallbackValue
  * @template-implements Iterator<TKey, TCallbackValue>
  */
-class CallbackIterator implements Iterator
+final class CallbackIterator implements Iterator
 {
     /** @var callable(TValue, TKey): TCallbackValue */
     private $callback;

src/Model/CallbackIterator.php

@@ -51,7 +51,7 @@
  * @template TValue of array|object
  * @template-extends IteratorIterator<int, TValue, CursorInterface<int, TValue>&Iterator<int, TValue>>
  */
-class ChangeStreamIterator extends IteratorIterator implements CommandSubscriber
+final class ChangeStreamIterator extends IteratorIterator implements CommandSubscriber
 {
     private int $batchPosition = 0;