Add OAuth Bearer Token Support (Experimental) (#77)

Co-authored-by: EncoreBot <[email protected]>

Author: onairmarc

.git-blame-ignore-revs

@@ -10,3 +10,5 @@ cbe36f817a31ddbeb1ef59120b2406f6e9d4a689
 fa4b60ada3c0013ece75995fe7d741e5ab3e80b4
 99bd1813b52dabee4f7a6e9fde1548dba008870c
 0301a888d15da0b7d5749d41a541e9d838ae8a5c
+ab97eabfaa74cf93c607153c1b128066cf5bc6ef
+17c9890cca2428bf9215a88a39da34d6fc57ab3c

src/Support/AuthType.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * Encore Digital Group - Planning Center PHP SDK
+ * Copyright (c) 2025. Encore Digital Group
+ */
+
+namespace EncoreDigitalGroup\PlanningCenter\Support;
+
+use EncoreDigitalGroup\StdLib\Objects\Support\Traits\HasEnumValue;
+
+/** @experimental This could change. Use with caution. */
+enum AuthType: string
+{
+    use HasEnumValue;
+
+    case Basic = "basic";
+    case Token = "token";
+}

src/Traits/HasPlanningCenterClient.php

@@ -2,13 +2,15 @@
 
 /*
  * Encore Digital Group - Planning Center PHP SDK
- * Copyright (c) 2023-2024. Encore Digital Group
+ * Copyright (c) 2023-2025. Encore Digital Group
  */
 
 namespace EncoreDigitalGroup\PlanningCenter\Traits;
 
 use EncoreDigitalGroup\PlanningCenter\Objects\SdkObjects\ClientResponse;
+use EncoreDigitalGroup\PlanningCenter\Support\AuthType;
 use EncoreDigitalGroup\PlanningCenter\Support\PlanningCenterApiVersion;
+use EncoreDigitalGroup\StdLib\Objects\Support\Types\Str;
 use Illuminate\Http\Client\PendingRequest;
 use Illuminate\Http\Client\Response;
 use PHPGenesis\Http\HttpClient;
@@ -18,22 +20,33 @@ trait HasPlanningCenterClient
 {
     protected const string HOSTNAME = "https://api.planningcenteronline.com";
 
+    /** @experimental This could change. Use with caution. */
+    protected const string X_PCO_API_VERSION_HEADER = "X-PCO-API-Version";
+
     protected string $clientId;
     protected string $clientSecret;
     protected string $apiVersion = "";
 
+    /** @experimental This could change. Use with caution. */
+    protected AuthType $authType = AuthType::Basic;
+
     public function __construct(?string $clientId = null, ?string $clientSecret = null)
     {
-        $this->clientId = $clientId ?? "";
-        $this->clientSecret = $clientSecret ?? "";
+        $this->clientId = $clientId ?? Str::empty();
+        $this->clientSecret = $clientSecret ?? Str::empty();
 
         new HttpClientBuilder;
     }
 
     public function client(): PendingRequest
     {
+        if ($this->authType == AuthType::Token) {
+            return HttpClient::withToken($this->clientId)
+                ->withHeader(self::X_PCO_API_VERSION_HEADER, $this->apiVersion);
+        }
+
         return HttpClient::withBasicAuth($this->clientId, $this->clientSecret)
-            ->withHeader("X-PCO-API-Version", $this->apiVersion);
+            ->withHeader(self::X_PCO_API_VERSION_HEADER, $this->apiVersion);
     }
 
     public function hostname(): string
@@ -48,6 +61,32 @@ public function setApiVersion(string $apiVersion): static
         return $this;
     }
 
+    /** @experimental This could change. Use with caution. */
+    public function setAuthType(AuthType $authType): static
+    {
+        $this->authType = $authType;
+
+        return $this;
+    }
+
+    /** @experimental This could change. Use with caution. */
+    public function withBasicAuth(string $clientId = "", string $clientSecret = ""): static
+    {
+        $this->clientId = $clientId;
+        $this->clientSecret = $clientSecret;
+
+        return $this->setAuthType(AuthType::Basic);
+    }
+
+    /** @experimental This could change. Use with caution. */
+    public function withToken(string $token = ""): static
+    {
+        $this->clientId = $token;
+        $this->clientSecret = Str::empty();
+
+        return $this->setAuthType(AuthType::Token);
+    }
+
     protected function processResponse(Response $http): ClientResponse
     {
         $clientResponse = new ClientResponse($http);