[pull] master from KnpLabs:master

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+    -   package-ecosystem: "github-actions"
+        directory: "/"
+        schedule:
+            interval: "weekly"

.github/workflows/backwards-compatibility.yml

@@ -8,11 +8,17 @@ jobs:
         name: "Roave BC check"
         runs-on: ubuntu-latest
         steps:
-            -   uses: actions/checkout@v2
+            -   uses: actions/checkout@v4
                 with:
                     fetch-depth: 0
 
-            -   name: Roave BC Check
-                uses: docker://nyholm/roave-bc-check-ga
+            -   name: Install PHP
+                uses: shivammathur/setup-php@v2
                 with:
-                    args: --from=${{ github.event.pull_request.base.sha }}
+                    php-version: '8.2'
+
+            -   name: Install roave/backward-compatibility-check
+                run: composer require --dev roave/backward-compatibility-check
+
+            -   name: Run roave/backward-compatibility-check
+                run: vendor/bin/roave-backward-compatibility-check --from=${{ github.event.pull_request.base.sha }} --format=github-actions

.github/workflows/ci.yml

@@ -11,10 +11,10 @@ jobs:
         strategy:
             fail-fast: false
             matrix:
-                php-versions: ['7.2', '7.3', '7.4', '8.0', '8.1']
+                php-versions: ['7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3', '8.4']
 
         steps:
-            - uses: actions/checkout@v2
+            - uses: actions/checkout@v4
 
             - name: Setup PHP
               uses: shivammathur/setup-php@v2
@@ -23,25 +23,27 @@ jobs:
                   coverage: none
 
             - name: Install Composer Dependencies
-              uses: ramsey/composer-install@v1
+              uses: ramsey/composer-install@v3
 
             - name: Run phpunit
               run: vendor/bin/phpunit --verbose
+              env:
+                  SYMFONY_DEPRECATIONS_HELPER: 'max[self]=0'
 
     phpstan:
         name: PHPStan
         runs-on: ubuntu-latest
 
         steps:
-            - uses: actions/checkout@v2
+            - uses: actions/checkout@v4
 
             - uses: shivammathur/setup-php@v2
               with:
                   php-version: 7.2
                   coverage: none
 
             - name: Install Composer Dependencies
-              uses: ramsey/composer-install@v1
+              uses: ramsey/composer-install@v3
 
             - name: Run phpstan
               run: vendor/bin/phpstan analyse --no-progress

CHANGELOG-3.X.md

@@ -1,5 +1,76 @@
 # Changelog
 
+## 3.16.0
+
+### Added
+- Add API to rerequest a check run ([Spea](https://github.com/Spea)) [#1141](https://github.com/KnpLabs/php-github-api/issues/1141)
+- List pull requests associated with a commit ([lmjhs](https://github.com/lmjhs)) [#1146](https://github.com/KnpLabs/php-github-api/issues/1146)
+
+## 3.15.0
+
+### Added
+- Fix implicit nullable types to avoid PHP 8.4 warnings ([eiriksm](https://github.com/eiriksm), [acrobat](https://github.com/acrobat)) [#1144](https://github.com/KnpLabs/php-github-api/issues/1144)
+- Add API endpoints to interact with organization roles ([glaubinix](https://github.com/glaubinix)) [#1143](https://github.com/KnpLabs/php-github-api/issues/1143)
+- Copilot Usage Endpoints ([anthony-webart](https://github.com/anthony-webart)) [#1142](https://github.com/KnpLabs/php-github-api/issues/1142)
+- Fix type error in ResultPager::fetch ([nunoplopes](https://github.com/nunoplopes)) [#1132](https://github.com/KnpLabs/php-github-api/issues/1132)
+
+## 3.14.1
+
+### Fixed
+- Handle case of GitHub returning 204 No Content in some scenarios ([tomcorbett](https://github.com/tomcorbett)) [#1135](https://github.com/KnpLabs/php-github-api/issues/1135)
+
+## 3.14.0
+
+### Added
+- Allow php-http/cache-plugin v2 ([GrahamCampbell](https://github.com/GrahamCampbell)) [#1134](https://github.com/KnpLabs/php-github-api/issues/1134)
+
+## 3.13.0
+
+### Added
+- Test against php 8.3 ([sergiy-petrov](https://github.com/sergiy-petrov)) [#1124](https://github.com/KnpLabs/php-github-api/issues/1124)
+- feat: Secret Scanning Alerts ([haridarshan](https://github.com/haridarshan)) [#1114](https://github.com/KnpLabs/php-github-api/issues/1114)
+- feat: User Migration ([haridarshan](https://github.com/haridarshan)) [#1115](https://github.com/KnpLabs/php-github-api/issues/1115)
+
+### Changed
+- General chores ([acrobat](https://github.com/acrobat)) [#1125](https://github.com/KnpLabs/php-github-api/issues/1125)
+
+### Fixed
+- Fix detection of secondary rate limit ([mathieudz](https://github.com/mathieudz)) [#1126](https://github.com/KnpLabs/php-github-api/issues/1126)
+
+## 3.12.0
+
+### Added
+- feat: Support for Organization Runners ([haridarshan](https://github.com/haridarshan), [renovate](https://github.com/renovate)[[bot](https://github.com/bot)]) [#1101](https://github.com/KnpLabs/php-github-api/issues/1101)
+- allow psr/http-message v2 ([LordSimal](https://github.com/LordSimal)) [#1122](https://github.com/KnpLabs/php-github-api/issues/1122)
+
+### Changed
+- Fixed branch alias ([GrahamCampbell](https://github.com/GrahamCampbell)) [#1109](https://github.com/KnpLabs/php-github-api/issues/1109)
+
+## 3.11.0
+
+### Added
+- Added environment variables & secrets ([Froxz](https://github.com/Froxz)) [#1104](https://github.com/KnpLabs/php-github-api/issues/1104)
+- Added Org & Repository variables ([Froxz](https://github.com/Froxz)) [#1106](https://github.com/KnpLabs/php-github-api/issues/1106)
+- Deployment branch policies ([Froxz](https://github.com/Froxz)) [#1108](https://github.com/KnpLabs/php-github-api/issues/1108)
+
+### Changed
+- Test on PHP 8.2 ([GrahamCampbell](https://github.com/GrahamCampbell)) [#1105](https://github.com/KnpLabs/php-github-api/issues/1105)
+
+### Fixed
+- Bugfix creating env ([Froxz](https://github.com/Froxz)) [#1107](https://github.com/KnpLabs/php-github-api/issues/1107)
+
+## 3.10.0
+
+### Added
+- Add vulnerability alerts endpoints ([andreia](https://github.com/andreia)) [#1096](https://github.com/KnpLabs/php-github-api/issues/1096)
+- Added environments ([Froxz](https://github.com/Froxz)) [#1103](https://github.com/KnpLabs/php-github-api/issues/1103)
+
+### Changed
+- Create authorization removed from docs ([rafasashi](https://github.com/rafasashi)) [#1090](https://github.com/KnpLabs/php-github-api/issues/1090)
+- Setup dependabot for github action workflows ([acrobat](https://github.com/acrobat)) [#1098](https://github.com/KnpLabs/php-github-api/issues/1098)
+- Bump actions/checkout from 2 to 3 ([dependabot](https://github.com/dependabot)[[bot](https://github.com/bot)]) [#1099](https://github.com/KnpLabs/php-github-api/issues/1099)
+- Bump ramsey/composer-install from 1 to 2 ([dependabot](https://github.com/dependabot)[[bot](https://github.com/bot)]) [#1100](https://github.com/KnpLabs/php-github-api/issues/1100)
+
 ## 3.9.0
 
 ### Added

composer.json

@@ -19,21 +19,21 @@
     "require": {
         "php": "^7.2.5 || ^8.0",
         "ext-json": "*",
-        "php-http/cache-plugin": "^1.7.1",
+        "php-http/cache-plugin": "^1.7.1|^2.0",
         "php-http/client-common": "^2.3",
         "php-http/discovery": "^1.12",
         "php-http/httplug": "^2.2",
         "php-http/multipart-stream-builder": "^1.1.2",
         "psr/cache": "^1.0|^2.0|^3.0",
         "psr/http-client-implementation": "^1.0",
         "psr/http-factory-implementation": "^1.0",
-        "psr/http-message": "^1.0",
+        "psr/http-message": "^1.0|^2.0",
         "symfony/polyfill-php80": "^1.17",
         "symfony/deprecation-contracts": "^2.2|^3.0"
     },
     "require-dev": {
         "symfony/cache": "^5.1.8",
-        "guzzlehttp/psr7": "^1.7",
+        "guzzlehttp/psr7": "^2.7",
         "http-interop/http-factory-guzzle": "^1.0",
         "guzzlehttp/guzzle": "^7.2",
         "php-http/mock-client": "^1.4.1",
@@ -52,13 +52,14 @@
     "extra": {
         "branch-alias": {
             "dev-2.x": "2.20.x-dev",
-            "dev-master": "3.9.x-dev"
+            "dev-master": "3.16-dev"
         }
     },
     "config": {
         "allow-plugins": {
             "phpstan/extension-installer": true,
-            "composer/package-versions-deprecated": true
+            "composer/package-versions-deprecated": true,
+            "php-http/discovery": true
         }
     }
 }

doc/README.md

@@ -14,6 +14,7 @@ v3 APIs:
   * [Public keys](currentuser/publickeys.md)
   * [Memberships](currentuser/memberships.md)
 * [Enterprise](enterprise.md)
+  * [Secret Scanning Alert](enterprise/secret-scanning.md)
 * [Gists](gists.md)
   * [Comments](gists/comments.md)
 * GitData
@@ -39,6 +40,11 @@ v3 APIs:
 * [Organization](organization.md)
   * [Members](organization/members.md)
   * [Teams](organization/teams.md)
+  * [Self hosted runners](organization/actions/self_hosted_runners.md)
+  * [Secrets](organization/actions/secrets.md)
+  * [Variables](organization/actions/variables.md)
+  * [Secret Scanning Alert](organization/secret-scanning.md)
+  * [Organization Roles](organization/organization-roles.md)
 * [Projects](project/projects.md)
   * [Columns](project/columns.md)
     * [Cards](project/cards.md)
@@ -51,6 +57,7 @@ v3 APIs:
   * Actions
     * [Artifacts](repo/actions/artifacts.md)
     * [Secrets](repo/actions/secrets.md)
+    * [Variables](repo/actions/variables.md)
     * [Self hosted runners](repo/actions/self_hosted_runners.md)
     * [Workflow jobs](repo/actions/workflow_jobs.md)
     * [Workflow runs](repo/actions/workflow_runs.md)
@@ -59,15 +66,21 @@ v3 APIs:
   * [Check Suites](repo/check_suites.md)
   * [Contents](repo/contents.md)
   * [Deployments](repo/deployments.md)
+    * [Policies](repo/deployments/policies.md)
+    * [Environments](repo/deployments/environments.md)
+        * [Secrets](repo/deployments/environment/secrets.md)
+        * [Variables](repo/deployments/environment/variables.md)
   * [Labels](repo/labels.md)
   * [Protection](repo/protection.md)
   * [Releases](repo/releases.md)
     * [Assets](repo/assets.md)
   * [Stargazers](repo/stargazers.md)
   * [Statuses](repo/statuses.md)
   * [Tags](repo/tags.md)
+  * [Secret Scanning Alert](repo/secret-scanning.md)
 * [Search](search.md)
 * [Users](users.md)
+  * [Migrations](user/migration.md)
 
 Additional features:
 

doc/commits.md

@@ -35,3 +35,11 @@ $commit = $client->api('repo')->commits()->compare('KnpLabs', 'php-github-api',
 ```
 
 Returns an array of commits.
+
+### List pull requests associated with a commit
+
+```php
+$commit = $client->api('repo')->commits()->pulls('KnpLabs', 'php-github-api', '839e5185da9434753db47959bee16642bb4f2ce4');
+```
+
+Returns an array of pull requests.

doc/copilot/usage.md

@@ -0,0 +1,80 @@
+# Copilot Usage API Documentation
+[Back to the navigation](../README.md)
+
+## Overview
+
+The Copilot Usage API provides endpoints to retrieve usage summaries for organizations and enterprises.
+
+**Note**: This endpoint is in beta and is subject to change.
+
+## Endpoints
+
+### Organization Usage Summary
+
+Retrieve the usage summary for a specific organization.
+
+**Method:** `GET`
+
+**Endpoint:** `/orgs/{organization}/copilot/usage`
+
+**Parameters:**
+- `organization` (string): The name of the organization.
+- `params` (array, optional): Additional query parameters.
+
+**Example:**
+```php
+$usage = $client->api('copilotUsage')->orgUsageSummary('KnpLabs');
+```
+
+### Organization Team Usage Summary
+
+Retrieve the usage summary for a specific team within an organization.
+
+**Method:** `GET`
+
+**Endpoint:** `/orgs/{organization}/team/{team}/copilot/usage`
+
+**Parameters:**
+- `organization` (string): The name of the organization.
+- `team` (string): The name of the team.
+- `params` (array, optional): Additional query parameters.
+
+**Example:**
+```php
+$usage = $client->api('copilotUsage')->orgTeamUsageSummary('KnpLabs', 'developers');
+```
+
+### Enterprise Usage Summary
+
+Retrieve the usage summary for a specific enterprise.
+
+**Method:** `GET`
+
+**Endpoint:** `/enterprises/{enterprise}/copilot/usage`
+
+**Parameters:**
+- `enterprise` (string): The name of the enterprise.
+- `params` (array, optional): Additional query parameters.
+
+**Example:**
+```php
+$usage = $client->api('copilotUsage')->enterpriseUsageSummary('KnpLabs');
+```
+
+### Enterprise Team Usage Summary
+
+Retrieve the usage summary for a specific team within an enterprise.
+
+**Method:** `GET`
+
+**Endpoint:** `/enterprises/{enterprise}/team/{team}/copilot/usage`
+
+**Parameters:**
+- `enterprise` (string): The name of the enterprise.
+- `team` (string): The name of the team.
+- `params` (array, optional): Additional query parameters.
+
+**Example:**
+```php
+$usage = $client->api('copilotUsage')->enterpriseTeamUsageSummary('KnpLabs', 'developers');
+```

doc/enterprise/secret-scanning.md

@@ -0,0 +1,10 @@
+## Enterprise / Secret Scanning API
+[Back to the "Enterprise API"](../../enterprise.md) | [Back to the navigation](../../README.md)
+
+# List secret-scanning alerts for an Enterprise
+
+https://docs.github.com/en/enterprise-server@3.5/rest/secret-scanning#list-secret-scanning-alerts-for-an-enterprise
+
+```php
+$alerts = $client->api('enterprise')->secretScanning()->alerts('KnpLabs');
+```

doc/organization/actions/self_hosted_runners.md

@@ -0,0 +1,51 @@
+## Organization / Actions / Self Hosted Runners API
+[Back to the "Organization API"](../../organization.md) | [Back to the navigation](../../README.md)
+
+# List self-hosted runners for an Organization
+
+https://docs.github.com/en/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-self-hosted-runners-for-an-organization
+
+```php
+$runners = $client->api('organization')->runners()->all('KnpLabs');
+```
+
+# Get a self-hosted runner for an Organization
+
+ https://docs.github.com/en/rest/actions/self-hosted-runners?apiVersion=2022-11-28#get-a-self-hosted-runner-for-an-organization
+
+```php
+$runner = $client->api('organization')->runners()->show('KnpLabs', $runnerId);
+```
+
+# Delete a self-hosted runner from an Organization
+
+https://docs.github.com/en/rest/actions/self-hosted-runners?apiVersion=2022-11-28#delete-a-self-hosted-runner-from-an-organization
+
+```php
+$client->api('organization')->runners()->remove('KnpLabs', $runnerId);
+```
+
+# List runner applications for an Organization
+
+https://docs.github.com/en/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-runner-applications-for-an-organization
+
+```php
+$applications = $client->api('organization')->selfHostedRunners()->applications('KnpLabs');
+```
+
+# List of all runners with Pagination
+
+```php
+$api = $github->api('organization')->runners();
+$paginator  = new Github\ResultPager($github);
+$parameters = array('KnpLabs');
+$runners = $paginator->fetchAll($api, 'all', $parameters);
+
+do {
+    foreach ($runners['runners'] as $runner) {
+        // code
+    }
+    $runners = $paginator->fetchNext();
+}
+while($paginator->hasNext());
+```