fix: add backward compatibility for event properties to prevent breaking changes

Add deprecated properties and getters for backward compatibility in events:

- BackupStatusChangedEvent: Add deprecated $publicKeyCredentialSource property
- BackupEligibilityChangedEvent: Add deprecated $publicKeyCredentialSource property
- AuthenticatorAssertionResponseValidationFailedEvent: Add deprecated $credentialSource property

These events had their properties renamed from $publicKeyCredentialSource (or $credentialSource)
to $credentialRecord in version 5.3. To maintain backward compatibility and prevent breaking
changes for users accessing these public properties, we add virtual properties using PHP 8.4's
property hooks that delegate to the new $credentialRecord property.

This ensures existing code continues to work while encouraging migration to the new property name.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: Spomky

src/webauthn/src/Event/AuthenticatorAssertionResponseValidationFailedEvent.php

@@ -25,26 +25,35 @@ public function __construct(
     /**
      * @deprecated since 5.3, use credentialRecord instead. Will be removed in 6.0.
      */
-    public function getPublicKeyCredentialSource(): PublicKeyCredentialSource
-    {
-        if ($this->credentialRecord instanceof PublicKeyCredentialSource) {
-            return $this->credentialRecord;
+    public PublicKeyCredentialSource $credentialSource {
+        get {
+            if ($this->credentialRecord instanceof PublicKeyCredentialSource) {
+                return $this->credentialRecord;
+            }
+
+            return PublicKeyCredentialSource::create(
+                $this->credentialRecord->publicKeyCredentialId,
+                $this->credentialRecord->type,
+                $this->credentialRecord->transports,
+                $this->credentialRecord->attestationType,
+                $this->credentialRecord->trustPath,
+                $this->credentialRecord->aaguid,
+                $this->credentialRecord->credentialPublicKey,
+                $this->credentialRecord->userHandle,
+                $this->credentialRecord->counter,
+                $this->credentialRecord->otherUI,
+                $this->credentialRecord->backupEligible,
+                $this->credentialRecord->backupStatus,
+                $this->credentialRecord->uvInitialized,
+            );
         }
+    }
 
-        return PublicKeyCredentialSource::create(
-            $this->credentialRecord->publicKeyCredentialId,
-            $this->credentialRecord->type,
-            $this->credentialRecord->transports,
-            $this->credentialRecord->attestationType,
-            $this->credentialRecord->trustPath,
-            $this->credentialRecord->aaguid,
-            $this->credentialRecord->credentialPublicKey,
-            $this->credentialRecord->userHandle,
-            $this->credentialRecord->counter,
-            $this->credentialRecord->otherUI,
-            $this->credentialRecord->backupEligible,
-            $this->credentialRecord->backupStatus,
-            $this->credentialRecord->uvInitialized,
-        );
+    /**
+     * @deprecated since 5.3, use credentialRecord instead. Will be removed in 6.0.
+     */
+    public function getPublicKeyCredentialSource(): PublicKeyCredentialSource
+    {
+        return $this->credentialSource;
     }
 }

src/webauthn/src/Event/BackupEligibilityChangedEvent.php

@@ -21,4 +21,39 @@ public function __construct(
         public ?bool $newValue
     ) {
     }
+
+    /**
+     * @deprecated since 5.3, use credentialRecord instead. Will be removed in 6.0.
+     */
+    public PublicKeyCredentialSource $publicKeyCredentialSource {
+        get {
+            if ($this->credentialRecord instanceof PublicKeyCredentialSource) {
+                return $this->credentialRecord;
+            }
+
+            return PublicKeyCredentialSource::create(
+                $this->credentialRecord->publicKeyCredentialId,
+                $this->credentialRecord->type,
+                $this->credentialRecord->transports,
+                $this->credentialRecord->attestationType,
+                $this->credentialRecord->trustPath,
+                $this->credentialRecord->aaguid,
+                $this->credentialRecord->credentialPublicKey,
+                $this->credentialRecord->userHandle,
+                $this->credentialRecord->counter,
+                $this->credentialRecord->otherUI,
+                $this->credentialRecord->backupEligible,
+                $this->credentialRecord->backupStatus,
+                $this->credentialRecord->uvInitialized,
+            );
+        }
+    }
+
+    /**
+     * @deprecated since 5.3, use credentialRecord instead. Will be removed in 6.0.
+     */
+    public function getPublicKeyCredentialSource(): PublicKeyCredentialSource
+    {
+        return $this->publicKeyCredentialSource;
+    }
 }

src/webauthn/src/Event/BackupStatusChangedEvent.php

@@ -22,4 +22,39 @@ public function __construct(
         public ?bool $newValue
     ) {
     }
+
+    /**
+     * @deprecated since 5.3, use credentialRecord instead. Will be removed in 6.0.
+     */
+    public PublicKeyCredentialSource $publicKeyCredentialSource {
+        get {
+            if ($this->credentialRecord instanceof PublicKeyCredentialSource) {
+                return $this->credentialRecord;
+            }
+
+            return PublicKeyCredentialSource::create(
+                $this->credentialRecord->publicKeyCredentialId,
+                $this->credentialRecord->type,
+                $this->credentialRecord->transports,
+                $this->credentialRecord->attestationType,
+                $this->credentialRecord->trustPath,
+                $this->credentialRecord->aaguid,
+                $this->credentialRecord->credentialPublicKey,
+                $this->credentialRecord->userHandle,
+                $this->credentialRecord->counter,
+                $this->credentialRecord->otherUI,
+                $this->credentialRecord->backupEligible,
+                $this->credentialRecord->backupStatus,
+                $this->credentialRecord->uvInitialized,
+            );
+        }
+    }
+
+    /**
+     * @deprecated since 5.3, use credentialRecord instead. Will be removed in 6.0.
+     */
+    public function getPublicKeyCredentialSource(): PublicKeyCredentialSource
+    {
+        return $this->publicKeyCredentialSource;
+    }
 }