From 9fe427a9c5b45071cc4ee1f0da97c6ca11ad32e1 Mon Sep 17 00:00:00 2001
From: Sebastian Lemke <s.lemke@infoworxx.de>
Date: Sun, 20 Apr 2025 23:30:33 +0200
Subject: [PATCH] added DeviceCode Grant

---
 src/Grant/DeviceCode.php          | 35 +++++++++++++++++++++++++++
 test/src/Grant/DeviceCodeTest.php | 39 +++++++++++++++++++++++++++++++
 2 files changed, 74 insertions(+)
 create mode 100644 src/Grant/DeviceCode.php
 create mode 100644 test/src/Grant/DeviceCodeTest.php

diff --git a/src/Grant/DeviceCode.php b/src/Grant/DeviceCode.php
new file mode 100644
index 00000000..b6dd4ec2
--- /dev/null
+++ b/src/Grant/DeviceCode.php
@@ -0,0 +1,35 @@
+<?php
+/**
+ * Implements "device_code" for league/oauth2-client library
+ *
+ * @copyright Copyright (c) Sebastian Lemke
+ * @license http://opensource.org/licenses/MIT MIT
+ */
+
+namespace League\OAuth2\Client\Grant;
+
+/**
+ * Represents a device authorization grant.
+ *
+ * @link https://tools.ietf.org/html/rfc8628
+ */
+class DeviceCode extends AbstractGrant
+{
+    /**
+     * @inheritdoc
+     */
+    protected function getName()
+    {
+        return 'urn:ietf:params:oauth:grant-type:device_code';
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function getRequiredRequestParameters()
+    {
+        return [
+            'device_code',
+        ];
+    }
+}
diff --git a/test/src/Grant/DeviceCodeTest.php b/test/src/Grant/DeviceCodeTest.php
new file mode 100644
index 00000000..714c6c4e
--- /dev/null
+++ b/test/src/Grant/DeviceCodeTest.php
@@ -0,0 +1,39 @@
+<?php
+
+namespace League\OAuth2\Client\Test\Grant;
+
+use BadMethodCallException;
+use League\OAuth2\Client\Grant\DeviceCode;
+
+class DeviceCodeTest extends GrantTestCase
+{
+    public static function providerGetAccessToken()
+    {
+        return [
+            ['device_code', ['device_code' => 'mock_device_code']],
+        ];
+    }
+
+    protected function getParamExpectation()
+    {
+        return function ($body) {
+            return !empty($body['grant_type'])
+                && $body['grant_type'] === 'urn:ietf:params:oauth:grant-type:device_code'
+                && !empty($body['device_code']);
+        };
+    }
+
+    public function testToString()
+    {
+        $grant = new DeviceCode();
+        $this->assertEquals('urn:ietf:params:oauth:grant-type:device_code', (string) $grant);
+    }
+
+    public function testInvalidDeviceCode()
+    {
+        $this->expectException(BadMethodCallException::class);
+
+        $this->getMockProvider()->getAccessToken('device_code', ['invalid_device_code' => 'mock_device_code']);
+    }
+
+}