Add wrapper for dependabot/alerts api

doc/organization.md

@@ -6,6 +6,7 @@ Wraps [GitHub Organization API](http://developer.github.com/v3/orgs/).
 Additional APIs:
 * [Members API](organization/members.md)
 * [Teams API](organization/teams.md)
+* [Dependabot API](organization/dependabot.md)
 
 ### List issues in an organization
 [GitHub Issues API](https://developer.github.com/v3/issues/).

doc/organization/dependabot.md

@@ -0,0 +1,11 @@
+## Organization / Dependabot API
+
+[Back to the "Organization API"](../../organization.md) | [Back to the navigation](../../README.md)
+
+# List Dependabot alerts for an Organization
+
+https://docs.github.com/en/rest/dependabot/alerts?apiVersion=2022-11-28#list-dependabot-alerts-for-an-organization
+
+```php
+$alerts = $client->api('organization')->dependabot()->alerts('KnpLabs', ['severity' => 'critical']);
+```

lib/Github/Api/Organization.php

@@ -5,6 +5,7 @@
 use Github\Api\Organization\Actions\Secrets;
 use Github\Api\Organization\Actions\SelfHostedRunners;
 use Github\Api\Organization\Actions\Variables;
+use Github\Api\Organization\Dependabot;
 use Github\Api\Organization\Hooks;
 use Github\Api\Organization\Members;
 use Github\Api\Organization\OutsideCollaborators;
@@ -158,4 +159,12 @@ public function secretScanning(): SecretScanning
     {
         return new SecretScanning($this->getClient());
     }
+
+    /**
+     * @return Dependabot
+     */
+    public function dependabot(): Dependabot
+    {
+        return new Dependabot($this->getClient());
+    }
 }

lib/Github/Api/Organization/Dependabot.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Github\Api\Organization;
+
+use Github\Api\AbstractApi;
+
+class Dependabot extends AbstractApi
+{
+    /**
+     * @link https://docs.github.com/en/rest/dependabot/alerts?apiVersion=2022-11-28#list-dependabot-alerts-for-an-organization
+     *
+     * @param string $organization
+     * @param array  $params
+     *
+     * @return array|string
+     */
+    public function alerts(string $organization, array $params = [])
+    {
+        return $this->get('/orgs/'.rawurlencode($organization).'/dependabot/alerts', $params);
+    }
+}

test/Github/Tests/Api/Organization/DependabotTest.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Github\Tests\Api\Organization;
+
+use Github\Api\Organization\SecretScanning;
+use Github\Tests\Api\TestCase;
+use PHPUnit\Framework\MockObject\MockObject;
+
+class DependabotTest extends TestCase
+{
+    /**
+     * @test
+     */
+    public function shouldGetAlerts()
+    {
+        $expectedArray = [
+            ['number' => 1, 'state' => 'open', 'severity' => 'critical'],
+        ];
+
+        /** @var SecretScanning|MockObject $api */
+        $api = $this->getApiMock();
+
+        $api
+            ->expects($this->once())
+            ->method('get')
+            ->with('/orgs/KnpLabs/dependabot/alerts')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->alerts('KnpLabs', [
+            'severity' => 'critical',
+        ]));
+    }
+
+    protected function getApiClass()
+    {
+        return \Github\Api\Organization\Dependabot::class;
+    }
+}