mark stack hydrator experimental

src/CoreExtension.php

@@ -7,6 +7,7 @@
 use Patchlevel\Hydrator\Guesser\BuiltInGuesser;
 use Patchlevel\Hydrator\Middleware\TransformMiddleware;
 
+/** @experimental */
 final class CoreExtension implements Extension
 {
     public function configure(StackHydratorBuilder $builder): void

src/Extension.php

@@ -4,6 +4,7 @@
 
 namespace Patchlevel\Hydrator;
 
+/** @experimental */
 interface Extension
 {
     public function configure(StackHydratorBuilder $builder): void;

src/Extension/Cryptography/Attribute/DataSubjectId.php

@@ -6,6 +6,7 @@
 
 use Attribute;
 
+/** @experimental */
 #[Attribute(Attribute::TARGET_PROPERTY)]
 final class DataSubjectId
 {

src/Extension/Cryptography/Attribute/SensitiveData.php

@@ -7,6 +7,7 @@
 use Attribute;
 use InvalidArgumentException;
 
+/** @experimental */
 #[Attribute(Attribute::TARGET_PROPERTY)]
 final class SensitiveData
 {

src/Extension/Cryptography/BaseCryptographer.php

@@ -20,6 +20,7 @@
 use function is_array;
 
 /**
+ * @experimental
  * @phpstan-type EncryptedDataV1 array{
  *     __enc: 'v1',
  *     data: non-empty-string,

src/Extension/Cryptography/Cipher/Cipher.php

@@ -4,6 +4,7 @@
 
 namespace Patchlevel\Hydrator\Extension\Cryptography\Cipher;
 
+/** @experimental */
 interface Cipher
 {
     /**

src/Extension/Cryptography/Cipher/CipherKey.php

@@ -4,6 +4,7 @@
 
 namespace Patchlevel\Hydrator\Extension\Cryptography\Cipher;
 
+/** @experimental */
 final class CipherKey
 {
     /**

src/Extension/Cryptography/Cipher/CipherKeyFactory.php

@@ -4,6 +4,7 @@
 
 namespace Patchlevel\Hydrator\Extension\Cryptography\Cipher;
 
+/** @experimental */
 interface CipherKeyFactory
 {
     /** @throws CreateCipherKeyFailed */

src/Extension/Cryptography/Cipher/CreateCipherKeyFailed.php

@@ -7,6 +7,7 @@
 use Patchlevel\Hydrator\HydratorException;
 use RuntimeException;
 
+/** @experimental */
 final class CreateCipherKeyFailed extends RuntimeException implements HydratorException
 {
     public function __construct()

src/Extension/Cryptography/Cipher/DecryptionFailed.php

@@ -7,6 +7,7 @@
 use Patchlevel\Hydrator\HydratorException;
 use RuntimeException;
 
+/** @experimental */
 final class DecryptionFailed extends RuntimeException implements HydratorException
 {
     public function __construct()

src/Extension/Cryptography/Cipher/EncryptionFailed.php

@@ -7,6 +7,7 @@
 use Patchlevel\Hydrator\HydratorException;
 use RuntimeException;
 
+/** @experimental */
 final class EncryptionFailed extends RuntimeException implements HydratorException
 {
     public function __construct()

src/Extension/Cryptography/Cipher/MethodNotSupported.php

@@ -9,6 +9,7 @@
 
 use function sprintf;
 
+/** @experimental */
 final class MethodNotSupported extends RuntimeException implements HydratorException
 {
     public function __construct(string $method)

src/Extension/Cryptography/Cipher/OpensslCipher.php

@@ -15,6 +15,7 @@
 
 use const JSON_THROW_ON_ERROR;
 
+/** @experimental */
 final class OpensslCipher implements Cipher
 {
     /** @return non-empty-string */

src/Extension/Cryptography/Cipher/OpensslCipherKeyFactory.php

@@ -11,6 +11,7 @@
 use function openssl_get_cipher_methods;
 use function openssl_random_pseudo_bytes;
 
+/** @experimental */
 final class OpensslCipherKeyFactory implements CipherKeyFactory
 {
     public const DEFAULT_METHOD = 'aes128';

src/Extension/Cryptography/Cryptographer.php

@@ -8,6 +8,7 @@
 use Patchlevel\Hydrator\Extension\Cryptography\Cipher\EncryptionFailed;
 use Patchlevel\Hydrator\Extension\Cryptography\Store\CipherKeyNotExists;
 
+/** @experimental */
 interface Cryptographer
 {
     /** @throws EncryptionFailed */

src/Extension/Cryptography/CryptographyExtension.php

@@ -7,6 +7,7 @@
 use Patchlevel\Hydrator\Extension;
 use Patchlevel\Hydrator\StackHydratorBuilder;
 
+/** @experimental */
 final class CryptographyExtension implements Extension
 {
     public function __construct(

src/Extension/Cryptography/CryptographyMetadataEnricher.php

@@ -12,6 +12,7 @@
 
 use function array_key_exists;
 
+/** @experimental */
 final class CryptographyMetadataEnricher implements MetadataEnricher
 {
     public function enrich(ClassMetadata $classMetadata): void

src/Extension/Cryptography/CryptographyMiddleware.php

@@ -19,6 +19,7 @@
 use function is_int;
 use function is_string;
 
+/** @experimental */
 final class CryptographyMiddleware implements Middleware
 {
     public function __construct(

src/Extension/Cryptography/DuplicateSubjectIdIdentifier.php

@@ -9,6 +9,7 @@
 
 use function sprintf;
 
+/** @experimental */
 final class DuplicateSubjectIdIdentifier extends RuntimeException implements MetadataException
 {
     /** @param class-string $class */

src/Extension/Cryptography/MissingSubjectId.php

@@ -9,6 +9,7 @@
 
 use function sprintf;
 
+/** @experimental */
 final class MissingSubjectId extends RuntimeException implements HydratorException
 {
     public function __construct(string $name)

src/Extension/Cryptography/MissingSubjectIdForField.php

@@ -9,6 +9,7 @@
 
 use function sprintf;
 
+/** @experimental */
 final class MissingSubjectIdForField extends RuntimeException implements HydratorException
 {
     /** @param class-string $class */

src/Extension/Cryptography/SensitiveDataInfo.php

@@ -4,6 +4,7 @@
 
 namespace Patchlevel\Hydrator\Extension\Cryptography;
 
+/** @experimental */
 final class SensitiveDataInfo
 {
     public function __construct(

src/Extension/Cryptography/Store/CipherKeyNotExists.php

@@ -9,6 +9,7 @@
 
 use function sprintf;
 
+/** @experimental */
 final class CipherKeyNotExists extends RuntimeException implements HydratorException
 {
     public function __construct(string $id)

src/Extension/Cryptography/Store/CipherKeyStore.php

@@ -6,6 +6,7 @@
 
 use Patchlevel\Hydrator\Extension\Cryptography\Cipher\CipherKey;
 
+/** @experimental */
 interface CipherKeyStore
 {
     /** @throws CipherKeyNotExists */

src/Extension/Cryptography/Store/InMemoryCipherKeyStore.php

@@ -6,6 +6,7 @@
 
 use Patchlevel\Hydrator\Extension\Cryptography\Cipher\CipherKey;
 
+/** @experimental */
 final class InMemoryCipherKeyStore implements CipherKeyStore
 {
     /** @var array<string, CipherKey> */

src/Extension/Cryptography/SubjectIdAndSensitiveDataConflict.php

@@ -9,6 +9,7 @@
 
 use function sprintf;
 
+/** @experimental */
 final class SubjectIdAndSensitiveDataConflict extends RuntimeException implements MetadataException
 {
     /** @param class-string $class */

src/Extension/Cryptography/SubjectIdFieldMapping.php

@@ -4,6 +4,7 @@
 
 namespace Patchlevel\Hydrator\Extension\Cryptography;
 
+/** @experimental */
 final class SubjectIdFieldMapping
 {
     /** @param array<string, string> $nameToField */

src/Extension/Cryptography/SubjectIds.php

@@ -6,6 +6,7 @@
 
 use function array_merge;
 
+/** @experimental */
 final class SubjectIds
 {
     /** @param array<string, string> $subjectIds */

src/Extension/Cryptography/UnsupportedSubjectId.php

@@ -10,6 +10,7 @@
 use function get_debug_type;
 use function sprintf;
 
+/** @experimental */
 final class UnsupportedSubjectId extends RuntimeException implements HydratorException
 {
     public function __construct(string $class, string $fieldName, mixed $subjectId)

src/Extension/Lifecycle/Attribute/PostExtract.php

@@ -6,6 +6,7 @@
 
 use Attribute;
 
+/** @experimental */
 #[Attribute(Attribute::TARGET_METHOD)]
 final class PostExtract
 {

src/Extension/Lifecycle/Attribute/PostHydrate.php

@@ -6,6 +6,7 @@
 
 use Attribute;
 
+/** @experimental */
 #[Attribute(Attribute::TARGET_METHOD)]
 final class PostHydrate
 {

src/Extension/Lifecycle/Attribute/PreExtract.php

@@ -6,6 +6,7 @@
 
 use Attribute;
 
+/** @experimental */
 #[Attribute(Attribute::TARGET_METHOD)]
 final class PreExtract
 {

src/Extension/Lifecycle/Attribute/PreHydrate.php

@@ -6,6 +6,7 @@
 
 use Attribute;
 
+/** @experimental */
 #[Attribute(Attribute::TARGET_METHOD)]
 final class PreHydrate
 {

src/Extension/Lifecycle/Lifecycle.php

@@ -4,6 +4,7 @@
 
 namespace Patchlevel\Hydrator\Extension\Lifecycle;
 
+/** @experimental */
 final readonly class Lifecycle
 {
     public function __construct(

src/Extension/Lifecycle/LifecycleExtension.php

@@ -7,6 +7,7 @@
 use Patchlevel\Hydrator\Extension;
 use Patchlevel\Hydrator\StackHydratorBuilder;
 
+/** @experimental */
 final readonly class LifecycleExtension implements Extension
 {
     public function configure(StackHydratorBuilder $builder): void

src/Extension/Lifecycle/LifecycleMetadataEnricher.php

@@ -14,6 +14,7 @@
 
 use function sprintf;
 
+/** @experimental */
 final class LifecycleMetadataEnricher implements MetadataEnricher
 {
     public function enrich(ClassMetadata $classMetadata): void

src/Extension/Lifecycle/LifecycleMiddleware.php

@@ -10,6 +10,7 @@
 
 use function assert;
 
+/** @experimental */
 final class LifecycleMiddleware implements Middleware
 {
     /**

src/Middleware/Middleware.php

@@ -6,6 +6,7 @@
 
 use Patchlevel\Hydrator\Metadata\ClassMetadata;
 
+/** @experimental */
 interface Middleware
 {
     /**

src/Middleware/NoMoreMiddleware.php

@@ -7,6 +7,7 @@
 use Patchlevel\Hydrator\HydratorException;
 use RuntimeException;
 
+/** @experimental */
 final class NoMoreMiddleware extends RuntimeException implements HydratorException
 {
     public function __construct()

src/Middleware/Stack.php

@@ -4,6 +4,7 @@
 
 namespace Patchlevel\Hydrator\Middleware;
 
+/** @experimental */
 final class Stack
 {
     private int $index = 0;

src/Middleware/TransformMiddleware.php

@@ -17,6 +17,7 @@
 use function array_values;
 use function spl_object_id;
 
+/** @experimental */
 final class TransformMiddleware implements Middleware
 {
     /** @var array<int, class-string> */

src/StackHydrator.php

@@ -18,6 +18,7 @@
 
 use const PHP_VERSION_ID;
 
+/** @experimental */
 final class StackHydrator implements HydratorWithContext
 {
     /** @var array<class-string, ClassMetadata> */

src/StackHydratorBuilder.php

@@ -18,6 +18,7 @@
 use function array_merge;
 use function krsort;
 
+/** @experimental */
 final class StackHydratorBuilder
 {
     private bool $defaultLazy = false;