[GitHubEnterprise-3.9] Update to 1.1.4-c2aa4f5795e9bf6be125020d39e6f7d7 from 1.1.4-42a2a604c0aaa815c28890c5dd246167

Detected Schema changes:

                                                                                
starting work.

                                                                                
Building original model for commit 9bef3e


                                                                                
SPEC: extracted 2 commits from history
├─┬Paths
│ ├─┬/repos/{owner}/{repo}/git/ref/{ref}
│ │ └─┬GET
│ │   └─┬Parameters
│ │     ├──[-] example (223151:16)
│ │     └──[M] description (223084:20)
│ ├─┬/repos/{owner}/{repo}/git/refs/{ref}
│ │ ├─┬DELETE
│ │ │ ├──[-] description (27310:20)
│ │ │ └─┬Parameters
│ │ │   ├──[-] example (223151:16)
│ │ │   └──[M] description (223084:20)
│ │ └─┬PATCH
│ │   ├──[-] description (27255:20)
│ │   └─┬Parameters
│ │     ├──[M] example (27272:18)
│ │     └──[M] description (27266:22)
│ └─┬/repos/{owner}/{repo}/git/matching-refs/{ref}
│   └─┬GET
│     └─┬Parameters
│       ├──[-] example (223151:16)
│       └──[M] description (223084:20)
└─┬Components
  ├──[-] parameters (223146:7)❌
  └─┬webhook-member-added
    └─┬changes
      ├──[-] properties (121340:13)❌
      └─┬permission
        └──[-] description (121325:28)

Date: 03/07/24 | Commit: New: etc/specs/GitHubEnterprise-3.9/previous.spec.yaml, Original: etc/specs/GitHubEnterprise-3.9/current.spec.yaml
Document Element | Total Changes | Breaking Changes
paths            | 10            | 0
components       | 3             | 2

❌  2 Breaking changes out of 13
INFO: Modifications: 5
INFO: Removals: 8
INFO: Breaking Removals: 2

Author: WyriHaximus

clients/GitHubEnterprise-3.9/etc/openapi-client-generator.state

@@ -17,6 +17,7 @@
 use ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded;
 use ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes;
 use ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes\Permission;
+use ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes\RoleName;
 use ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberEdited;
 use ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberEdited\Changes\OldPermission;
 use ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberRemoved;
@@ -58,6 +59,7 @@ public function hydrateObject(string $className, array $payload): object
             'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded' => $this->hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded($payload),
                 'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes' => $this->hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes($payload),
                 'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes\Permission' => $this->hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes⚡️Permission($payload),
+                'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes\RoleName' => $this->hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes⚡️RoleName($payload),
                 'ApiClients\Client\GitHubEnterprise\Schema\EnterpriseWebhooks' => $this->hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️EnterpriseWebhooks($payload),
                 'ApiClients\Client\GitHubEnterprise\Schema\SimpleInstallation' => $this->hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️SimpleInstallation($payload),
                 'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Member' => $this->hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Member($payload),
@@ -275,6 +277,26 @@ private function hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema
             $properties['permission'] = $value;
 
             after_permission:
+
+            $value = $payload['role_name'] ?? null;
+
+            if ($value === null) {
+                $properties['roleName'] = null;
+                goto after_roleName;
+            }
+
+            if (is_array($value)) {
+                try {
+                    $this->hydrationStack[] = 'roleName';
+                    $value                  = $this->hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes⚡️RoleName($value);
+                } finally {
+                    array_pop($this->hydrationStack);
+                }
+            }
+
+            $properties['roleName'] = $value;
+
+            after_roleName:
         } catch (Throwable $exception) {
             throw UnableToHydrateObject::dueToError('ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes', $exception, stack: $this->hydrationStack);
         }
@@ -320,6 +342,36 @@ private function hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema
         }
     }
 
+    private function hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes⚡️RoleName(array $payload): RoleName
+    {
+        $properties    = [];
+        $missingFields = [];
+        try {
+            $value = $payload['to'] ?? null;
+
+            if ($value === null) {
+                $missingFields[] = 'to';
+                goto after_to;
+            }
+
+            $properties['to'] = $value;
+
+            after_to:
+        } catch (Throwable $exception) {
+            throw UnableToHydrateObject::dueToError('ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes\RoleName', $exception, stack: $this->hydrationStack);
+        }
+
+        if (count($missingFields) > 0) {
+            throw UnableToHydrateObject::dueToMissingFields(RoleName::class, $missingFields, stack: $this->hydrationStack);
+        }
+
+        try {
+            return new RoleName(...$properties);
+        } catch (Throwable $exception) {
+            throw UnableToHydrateObject::dueToError('ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes\RoleName', $exception, stack: $this->hydrationStack);
+        }
+    }
+
     private function hydrateApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️EnterpriseWebhooks(array $payload): EnterpriseWebhooks
     {
         $properties    = [];
@@ -4972,6 +5024,7 @@ public function serializeObjectOfType(object $object, string $className): mixed
                 'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded' => $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded($object),
                 'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes' => $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes($object),
                 'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes\Permission' => $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes⚡️Permission($object),
+                'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Changes\RoleName' => $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes⚡️RoleName($object),
                 'ApiClients\Client\GitHubEnterprise\Schema\EnterpriseWebhooks' => $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️EnterpriseWebhooks($object),
                 'ApiClients\Client\GitHubEnterprise\Schema\SimpleInstallation' => $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️SimpleInstallation($object),
                 'ApiClients\Client\GitHubEnterprise\Schema\WebhookMemberAdded\Member' => $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Member($object),
@@ -5131,6 +5184,15 @@ private function serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡
         $permission                                    = $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes⚡️Permission($permission);
         after_permission:        $result['permission'] = $permission;
 
+        $roleName = $object->roleName;
+
+        if ($roleName === null) {
+            goto after_roleName;
+        }
+
+        $roleName                                   = $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes⚡️RoleName($roleName);
+        after_roleName:        $result['role_name'] = $roleName;
+
         return $result;
     }
 
@@ -5145,6 +5207,17 @@ private function serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡
         return $result;
     }
 
+    private function serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️WebhookMemberAdded⚡️Changes⚡️RoleName(mixed $object): mixed
+    {
+        assert($object instanceof RoleName);
+        $result = [];
+
+        $to                            = $object->to;
+        after_to:        $result['to'] = $to;
+
+        return $result;
+    }
+
     private function serializeObjectApiClients⚡️Client⚡️GitHubEnterprise⚡️Schema⚡️EnterpriseWebhooks(mixed $object): mixed
     {
         assert($object instanceof EnterpriseWebhooks);

clients/GitHubEnterprise-3.9/src/Internal/Hydrator/WebHook/Member.php

@@ -27,7 +27,7 @@ final class DeleteRef
     private string $owner;
     /**The name of the repository without the `.git` extension. The name is not case sensitive. **/
     private string $repo;
-    /**The commit reference. Can be a commit SHA, branch name (`heads/BRANCH_NAME`), or tag name (`tags/TAG_NAME`). For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. **/
+    /**The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. **/
     private string $ref;
 
     public function __construct(private readonly SchemaValidator $responseSchemaValidator, private readonly Internal\Hydrator\Operation\Repos\Owner\Repo\Git\Refs\Ref $hydrator, string $owner, string $repo, string $ref)

clients/GitHubEnterprise-3.9/src/Internal/Hydrators.php

@@ -26,7 +26,7 @@ final class GetRef
     private string $owner;
     /**The name of the repository without the `.git` extension. The name is not case sensitive. **/
     private string $repo;
-    /**The commit reference. Can be a commit SHA, branch name (`heads/BRANCH_NAME`), or tag name (`tags/TAG_NAME`). For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. **/
+    /**The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. **/
     private string $ref;
 
     public function __construct(private readonly SchemaValidator $responseSchemaValidator, private readonly Internal\Hydrator\Operation\Repos\Owner\Repo\Git\Ref\Ref $hydrator, string $owner, string $repo, string $ref)

clients/GitHubEnterprise-3.9/src/Internal/Operation/Git/DeleteRef.php

@@ -28,7 +28,7 @@ final class ListMatchingRefs
     private string $owner;
     /**The name of the repository without the `.git` extension. The name is not case sensitive. **/
     private string $repo;
-    /**The commit reference. Can be a commit SHA, branch name (`heads/BRANCH_NAME`), or tag name (`tags/TAG_NAME`). For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. **/
+    /**The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. **/
     private string $ref;
 
     public function __construct(private readonly SchemaValidator $responseSchemaValidator, private readonly Internal\Hydrator\Operation\Repos\Owner\Repo\Git\MatchingRefs\Ref $hydrator, string $owner, string $repo, string $ref)

clients/GitHubEnterprise-3.9/src/Internal/Operation/Git/GetRef.php

@@ -27,7 +27,7 @@ final class UpdateRef
     private string $owner;
     /**The name of the repository without the `.git` extension. The name is not case sensitive. **/
     private string $repo;
-    /**The name of the reference to update (for example, `heads/featureA`). Can be a branch name (`heads/BRANCH_NAME`) or tag name (`tags/TAG_NAME`). For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. **/
+    /**The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. **/
     private string $ref;
 
     public function __construct(private readonly SchemaValidator $requestSchemaValidator, private readonly SchemaValidator $responseSchemaValidator, private readonly Internal\Hydrator\Operation\Repos\Owner\Repo\Git\Refs\Ref $hydrator, string $owner, string $repo, string $ref)

clients/GitHubEnterprise-3.9/src/Internal/Operation/Git/ListMatchingRefs.php

@@ -24,6 +24,7 @@ public function __construct(private Browser $browser, private AuthenticationInte
     {
     }
 
+    /** @return */
     public function call(string $owner, string $repo, string $environmentName, array $params): EmptyObject
     {
         $operation = new \ApiClients\Client\GitHubEnterprise\Internal\Operation\Actions\CreateEnvironmentVariable($this->requestSchemaValidator, $this->responseSchemaValidator, $this->hydrator, $owner, $repo, $environmentName);

clients/GitHubEnterprise-3.9/src/Internal/Operation/Git/UpdateRef.php

@@ -25,6 +25,7 @@ public function __construct(private Browser $browser, private AuthenticationInte
     {
     }
 
+    /** @return */
     public function call(string $owner, string $repo, string $environmentName, string $secretName, array $params): EmptyObject|WithoutBody
     {
         $operation = new \ApiClients\Client\GitHubEnterprise\Internal\Operation\Actions\CreateOrUpdateEnvironmentSecret($this->requestSchemaValidator, $this->responseSchemaValidator, $this->hydrator, $owner, $repo, $environmentName, $secretName);

clients/GitHubEnterprise-3.9/src/Internal/Operator/Actions/CreateEnvironmentVariable.php

@@ -22,6 +22,7 @@ public function __construct(private Browser $browser, private AuthenticationInte
     {
     }
 
+    /** @return */
     public function call(string $owner, string $repo, string $environmentName, string $secretName): WithoutBody
     {
         $operation = new \ApiClients\Client\GitHubEnterprise\Internal\Operation\Actions\DeleteEnvironmentSecret($owner, $repo, $environmentName, $secretName);