Merge pull request #1096 from php-api-clients/GitHub/from-1.1.4-b56f269fa7811532d191d959eab59a6b-from-1.1.4-b56f269fa7811532d191d959eab59a6b

Author: WyriHaximus

clients/GitHub/README.md

@@ -17676,13 +17676,15 @@ Using the `call` method:
 $client->call('GET /repos/{owner}/{repo}/license', [
         'owner' => 'generated',
         'repo' => 'generated',
+        'ref' => 'generated',
 ]);
 ```
 
 Operations method:
 ```php
 $client->operations()->licenses()->getForRepo(        owner: 'generated',
         repo: 'generated',
+        ref: 'generated',
 );
 ```
 

clients/GitHub/etc/openapi-client-generator.state

@@ -1,5 +1,5 @@
 {
-    "specHash": "2bcf4a7ffd1c08c4653f4fa12fbb7e3f",
+    "specHash": "b56f269fa7811532d191d959eab59a6b",
     "generatedFiles": {
         "files": [
             {
@@ -5756,7 +5756,7 @@
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/Operation\/Licenses.php",
-                "hash": "7c5326d1d574b9efdd3619ac4e0c3670"
+                "hash": "cd7dd0390e80643ada325b5e346a44b0"
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/Operation\/Markdown.php",
@@ -21828,15 +21828,15 @@
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/Internal\/Operation\/Licenses\/GetForRepo.php",
-                "hash": "d39d1d47862837d138b2e749e295a068"
+                "hash": "77c035595b91d5878035f51019cfd6b0"
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/Internal\/Operator\/Licenses\/GetForRepo.php",
-                "hash": "49069ec06b26280f205df1c6bc1b2b14"
+                "hash": "b766a41e249ffdf739d434f8edff0c29"
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/tests\/\/Internal\/Operation\/Licenses\/GetForRepoTest.php",
-                "hash": "00b555c093f752b22eaa6d8e0c4e6082"
+                "hash": "07daedeba23c59ee46b7300d3b337c12"
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/Internal\/Operation\/Repos\/MergeUpstream.php",
@@ -26348,7 +26348,7 @@
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/Internal\/Router\/Get\/Licenses.php",
-                "hash": "e40d398894a18c495c8bf4436613e8d9"
+                "hash": "d016a7acdd3c9e968869ebc52993241e"
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/Internal\/Router\/Get\/Orgs.php",
@@ -26852,7 +26852,7 @@
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/Internal\/Router\/Get\/Five.php",
-                "hash": "a74e39ca54dba0682475b255dcea9c6d"
+                "hash": "b910424e796b3b1a789a1a8d2fd1c0a7"
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/Internal\/Router\/Get\/Six.php",
@@ -29708,11 +29708,11 @@
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/PHPStan\/ClientCallReturnTypes.php",
-                "hash": "deef79abe0f45342aaf83a90f84ecb93"
+                "hash": "9fe2d0166d211fbd94b58c43385b0465"
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/tests\/\/Types\/ClientCallReturnTypes.php",
-                "hash": "991da0fe5ffea896a5600ac51aae08c8"
+                "hash": "f4ab17a66cac87bfd47ccd52ba95d301"
             },
             {
                 "name": ".\/clients\/GitHub\/etc\/..\/\/src\/\/..\/etc\/phpstan-extension.neon",

clients/GitHub/src/Internal/Operation/Licenses/GetForRepo.php

@@ -26,16 +26,19 @@ final class GetForRepo
     private string $owner;
     /**The name of the repository without the `.git` extension. The name is not case sensitive. **/
     private string $repo;
+    /**The Git reference for the results you want to list. The `ref` for a branch can be formatted either as `refs/heads/<branch name>` or simply `<branch name>`. To reference a pull request use `refs/pull/<number>/merge`. **/
+    private string $ref;
 
-    public function __construct(private readonly SchemaValidator $responseSchemaValidator, private readonly Internal\Hydrator\Operation\Repos\Owner\Repo\License $hydrator, string $owner, string $repo)
+    public function __construct(private readonly SchemaValidator $responseSchemaValidator, private readonly Internal\Hydrator\Operation\Repos\Owner\Repo\License $hydrator, string $owner, string $repo, string $ref)
     {
         $this->owner = $owner;
         $this->repo  = $repo;
+        $this->ref   = $ref;
     }
 
     public function createRequest(): RequestInterface
     {
-        return new Request('GET', str_replace(['{owner}', '{repo}'], [$this->owner, $this->repo], '/repos/{owner}/{repo}/license'));
+        return new Request('GET', str_replace(['{owner}', '{repo}', '{ref}'], [$this->owner, $this->repo, $this->ref], '/repos/{owner}/{repo}/license' . '?ref={ref}'));
     }
 
     public function createResponse(ResponseInterface $response): Schema\LicenseContent

clients/GitHub/src/Internal/Operator/Licenses/GetForRepo.php

@@ -24,10 +24,9 @@ public function __construct(private Browser $browser, private AuthenticationInte
     {
     }
 
-    /** @return */
-    public function call(string $owner, string $repo): LicenseContent
+    public function call(string $owner, string $repo, string $ref): LicenseContent
     {
-        $operation = new \ApiClients\Client\GitHub\Internal\Operation\Licenses\GetForRepo($this->responseSchemaValidator, $this->hydrator, $owner, $repo);
+        $operation = new \ApiClients\Client\GitHub\Internal\Operation\Licenses\GetForRepo($this->responseSchemaValidator, $this->hydrator, $owner, $repo, $ref);
         $request   = $operation->createRequest();
         $result    = await($this->browser->request($request->getMethod(), (string) $request->getUri(), $request->withHeader('Authorization', $this->authentication->authHeader())->getHeaders(), (string) $request->getBody())->then(static function (ResponseInterface $response) use ($operation): LicenseContent {
             return $operation->createResponse($response);

clients/GitHub/src/Internal/Router/Get/Five.php

@@ -49,7 +49,7 @@ public function __construct(private Routers $routers)
     {
     }
 
-    /** @return |Observable<Schema\DependabotAlertWithRepository>|WithoutBody|Observable<Schema\OrganizationSecretScanningAlert>|Observable<Schema\MarketplacePurchase>|Observable<Schema\Event>|Schema\BasicError|Observable<Schema\CodeScanningOrganizationAlertItems>|Observable<Schema\Package>|Observable<Schema\OrgCustomProperty>|Observable<Schema\OrgRepoCustomPropertyValues>|Observable<Schema\RuleSuites>|Observable<Schema\ProjectCard>|Observable<Schema\Activity>|Observable<Schema\SimpleUser>|Observable<Schema\Autolink>|Observable<Schema\ShortBranch>|Observable<Schema\Collaborator>|Observable<Schema\CommitComment>|Observable<Schema\Commit>|Observable<Schema\Contributor>|Observable<Schema\Deployment>|Observable<Schema\MinimalRepository>|Observable<Schema\Hook>|Observable<Schema\RepositoryInvitation>|Observable<Schema\Issue>|Observable<Schema\DeployKey>|Observable<Schema\Label>|Observable<Schema\Milestone>|Observable<Schema\Thread>|Observable<Schema\Project>|Observable<Schema\PullRequestSimple>|Observable<Schema\Release>|Observable<Schema\RepositoryRuleset>|Observable<Schema\RepositoryAdvisory>|Observable<Schema\Tag>|Observable<Schema\Team> */
+    /** @return |Observable<Schema\DependabotAlertWithRepository>|WithoutBody|Observable<Schema\OrganizationSecretScanningAlert>|Observable<Schema\MarketplacePurchase>|Observable<Schema\Event>|Schema\BasicError|Observable<Schema\CodeScanningOrganizationAlertItems>|Observable<Schema\Package>|Observable<Schema\OrgCustomProperty>|Observable<Schema\OrgRepoCustomPropertyValues>|Observable<Schema\RuleSuites>|Observable<Schema\ProjectCard>|Observable<Schema\Activity>|Observable<Schema\SimpleUser>|Observable<Schema\Autolink>|Observable<Schema\ShortBranch>|Observable<Schema\Collaborator>|Observable<Schema\CommitComment>|Observable<Schema\Commit>|Observable<Schema\Contributor>|Observable<Schema\Deployment>|Observable<Schema\MinimalRepository>|Observable<Schema\Hook>|Observable<Schema\RepositoryInvitation>|Observable<Schema\Issue>|Observable<Schema\DeployKey>|Observable<Schema\Label>|Schema\LicenseContent|Observable<Schema\Milestone>|Observable<Schema\Thread>|Observable<Schema\Project>|Observable<Schema\PullRequestSimple>|Observable<Schema\Release>|Observable<Schema\RepositoryRuleset>|Observable<Schema\RepositoryAdvisory>|Observable<Schema\Tag>|Observable<Schema\Team> */
     public function call(string $call, array $params, array $pathChunks): HookDelivery|iterable|WithoutBody|GistComment|MarketplacePurchase|BasicError|ThreadSubscription|ActionsOrganizationPermissions|Ok|\ApiClients\Client\GitHub\Schema\Operations\Actions\ListOrgSecrets\Response\ApplicationJson\Ok|\ApiClients\Client\GitHub\Schema\Operations\Actions\ListOrgVariables\Response\ApplicationJson\Ok|\ApiClients\Client\GitHub\Schema\Operations\Codespaces\ListOrgSecrets\Response\ApplicationJson\Ok|CopilotOrganizationDetails|\ApiClients\Client\GitHub\Schema\Operations\Dependabot\ListOrgSecrets\Response\ApplicationJson\Ok|OrgHook|OrgMembership|Migration|OrganizationRole|RepositoryRuleset|TeamFull|ProjectCard|CheckAutomatedSecurityFixes|Json|\ApiClients\Client\GitHub\Schema\Operations\Repos\GetAllEnvironments\Response\ApplicationJson\Ok|Import|Installation|InteractionLimitResponse|One|Language|LicenseContent|Page|ContentFile|SimpleUser|Stargazer|RepositorySubscription|Topic|TeamDiscussion|TeamMembership|TeamProject|CodespacesUserPublicKey|CodespacesSecret|\ApiClients\Client\GitHub\Schema\Operations\Codespaces\CodespaceMachinesForAuthenticatedUser\Response\ApplicationJson\Ok\Application\Json|\ApiClients\Client\GitHub\Schema\Operations\Apps\ListInstallationReposForAuthenticatedUser\Response\ApplicationJson\Ok|Package
     {
         if ($pathChunks[0] === '') {

clients/GitHub/src/Internal/Router/Get/Licenses.php

@@ -64,7 +64,6 @@ public function get(array $params): License|WithoutBody
         return $operator->call($arguments['license']);
     }
 
-    /** @return */
     public function getForRepo(array $params): LicenseContent
     {
         $arguments = [];
@@ -80,8 +79,14 @@ public function getForRepo(array $params): LicenseContent
 
         $arguments['repo'] = $params['repo'];
         unset($params['repo']);
+        if (array_key_exists('ref', $params) === false) {
+            throw new InvalidArgumentException('Missing mandatory field: ref');
+        }
+
+        $arguments['ref'] = $params['ref'];
+        unset($params['ref']);
         $operator = new Internal\Operator\Licenses\GetForRepo($this->browser, $this->authentication, $this->responseSchemaValidator, $this->hydrators->getObjectMapperOperation🌀Repos🌀Owner🌀Repo🌀License());
 
-        return $operator->call($arguments['owner'], $arguments['repo']);
+        return $operator->call($arguments['owner'], $arguments['repo'], $arguments['ref']);
     }
 }

clients/GitHub/src/Operation/Licenses.php

@@ -34,9 +34,8 @@ public function get(string $license): License|WithoutBody
         return $this->operators->licenses👷Get()->call($license);
     }
 
-    /** @return */
-    public function getForRepo(string $owner, string $repo): LicenseContent
+    public function getForRepo(string $owner, string $repo, string $ref): LicenseContent
     {
-        return $this->operators->licenses👷GetForRepo()->call($owner, $repo);
+        return $this->operators->licenses👷GetForRepo()->call($owner, $repo, $ref);
     }
 }

clients/GitHub/src/PHPStan/ClientCallReturnTypes.php

@@ -2924,7 +2924,7 @@ public function getTypeFromMethodCall(MethodReflection $methodReflection, Method
         }
 
         if ($call === 'GET /repos/{owner}/{repo}/license') {
-            return $this->typeResolver->resolve('');
+            return $this->typeResolver->resolve('Schema\\LicenseContent');
         }
 
         if ($call === 'POST /repos/{owner}/{repo}/merge-upstream') {

clients/GitHub/tests/Internal/Operation/Licenses/GetForRepoTest.php

@@ -30,11 +30,12 @@ public function call_httpCode_200_responseContentType_application_json_zero(): v
         $browser = $this->prophesize(Browser::class);
         $browser->withBase(Argument::any())->willReturn($browser->reveal());
         $browser->withFollowRedirects(Argument::any())->willReturn($browser->reveal());
-        $browser->request('GET', '/repos/generated/generated/license', Argument::type('array'), Argument::any())->willReturn(resolve($response))->shouldBeCalled();
+        $browser->request('GET', '/repos/generated/generated/license?ref=generated', Argument::type('array'), Argument::any())->willReturn(resolve($response))->shouldBeCalled();
         $client = new Client($auth->reveal(), $browser->reveal());
         $result = $client->call(Internal\Operation\Licenses\GetForRepo::OPERATION_MATCH, (static function (array $data): array {
             $data['owner'] = 'generated';
             $data['repo']  = 'generated';
+            $data['ref']   = 'generated';
 
             return $data;
         })([]));
@@ -49,9 +50,9 @@ public function operations_httpCode_200_responseContentType_application_json_zer
         $browser = $this->prophesize(Browser::class);
         $browser->withBase(Argument::any())->willReturn($browser->reveal());
         $browser->withFollowRedirects(Argument::any())->willReturn($browser->reveal());
-        $browser->request('GET', '/repos/generated/generated/license', Argument::type('array'), Argument::any())->willReturn(resolve($response))->shouldBeCalled();
+        $browser->request('GET', '/repos/generated/generated/license?ref=generated', Argument::type('array'), Argument::any())->willReturn(resolve($response))->shouldBeCalled();
         $client = new Client($auth->reveal(), $browser->reveal());
-        $result = $client->operations()->licenses()->getForRepo('generated', 'generated');
+        $result = $client->operations()->licenses()->getForRepo('generated', 'generated', 'generated');
     }
 
     /** @test */
@@ -64,11 +65,12 @@ public function call_httpCode_404_responseContentType_application_json_zero(): v
         $browser = $this->prophesize(Browser::class);
         $browser->withBase(Argument::any())->willReturn($browser->reveal());
         $browser->withFollowRedirects(Argument::any())->willReturn($browser->reveal());
-        $browser->request('GET', '/repos/generated/generated/license', Argument::type('array'), Argument::any())->willReturn(resolve($response))->shouldBeCalled();
+        $browser->request('GET', '/repos/generated/generated/license?ref=generated', Argument::type('array'), Argument::any())->willReturn(resolve($response))->shouldBeCalled();
         $client = new Client($auth->reveal(), $browser->reveal());
         $result = $client->call(Internal\Operation\Licenses\GetForRepo::OPERATION_MATCH, (static function (array $data): array {
             $data['owner'] = 'generated';
             $data['repo']  = 'generated';
+            $data['ref']   = 'generated';
 
             return $data;
         })([]));
@@ -84,8 +86,8 @@ public function operations_httpCode_404_responseContentType_application_json_zer
         $browser = $this->prophesize(Browser::class);
         $browser->withBase(Argument::any())->willReturn($browser->reveal());
         $browser->withFollowRedirects(Argument::any())->willReturn($browser->reveal());
-        $browser->request('GET', '/repos/generated/generated/license', Argument::type('array'), Argument::any())->willReturn(resolve($response))->shouldBeCalled();
+        $browser->request('GET', '/repos/generated/generated/license?ref=generated', Argument::type('array'), Argument::any())->willReturn(resolve($response))->shouldBeCalled();
         $client = new Client($auth->reveal(), $browser->reveal());
-        $result = $client->operations()->licenses()->getForRepo('generated', 'generated');
+        $result = $client->operations()->licenses()->getForRepo('generated', 'generated', 'generated');
     }
 }

clients/GitHub/tests/Types/ClientCallReturnTypes.php

@@ -737,7 +737,7 @@ function authHeader(): string
 assertType('', $client->call('DELETE /repos/{owner}/{repo}/labels/{name}'));
 assertType('', $client->call('PATCH /repos/{owner}/{repo}/labels/{name}'));
 assertType('', $client->call('GET /repos/{owner}/{repo}/languages'));
-assertType('', $client->call('GET /repos/{owner}/{repo}/license'));
+assertType('Schema\\LicenseContent', $client->call('GET /repos/{owner}/{repo}/license'));
 assertType('', $client->call('POST /repos/{owner}/{repo}/merge-upstream'));
 assertType('', $client->call('POST /repos/{owner}/{repo}/merges'));
 assertType('Observable<Schema\\Milestone>', $client->call('GET /repos/{owner}/{repo}/milestones'));