Easy Extensibility vs. Core Integration

<?xml version="1.0" encoding="UTF-8"?>
<model package="oauth" baseClass="xPDOObject" platform="mysql" defaultEngine="MyISAM" version="1.1">


    <object class="OAuthServiceType" table="oauth_clients" extends="xPDOSimpleObject">
        <field key="name" dbtype="varchar" precision="100" phptype="string" null="false" />
        <field key="path" dbtype="varchar" precision="255" phptype="string" null="false" default="" />
        <field key="client_id" dbtype="varchar" precision="255" phptype="string" null="false" default="" />
        <field key="client_secret" dbtype="varchar" precision="255" phptype="string" null="false" default="" />
        <composite alias="Tokens" class="OAuthToken" local="id" foreign="service" cardinality="many" owner="local" />
    </object>

    <object class="OAuthToken" table="oauth_tokens" extends="xPDOSimpleObject">
        <field key="service" dbtype="int" precision="11" attributes="unsigned" phptype="integer" null="false" />
        <field key="user" dbtype="int" precision="11" attributes="unsigned" phptype="integer" null="false" />
        <field key="oauth_state" dbtype="varchar" precision="255" phptype="string" null="false" />
        <field key="token_granted" dbtype="datetime" phptype="string" null="false" />
        <field key="oauth_token" dbtype="varchar" precision="255" phptype="string" null="false" />
        <composite alias="User" class="modUser" local="user" foreign="id" cardinality="one" owner="foreign" />
        <composite alias="Service" class="OAuthServiceType" local="service" foreign="id" cardinality="one" owner="foreign" />
    </object>

</model>

<?php
    $modx->getService('OAuth',$path_to_class);

    /** @var string Name of xpdo/OAuthServiceType object to load */
    $serviceName = 'GitHib';

    /** @var int ID of user to initialize the connection for. 0 is master account. */
    $modxUserId  = 0; 

    /**
     * Load an instance of a class capable of authorizing & communicating with the oauthService 
     * @var TheClassTypeInQuestion
     */
    $github = $modx->OAuth->load('GitHub');


    if($github->authorized){
        // We have an auth token, go ahead and query the API
        $apiResponse = $github->GET('/path/to/endpoint');
    } else {
        // No auth token, need to do authorization flow
        $authUrl = $github->getAuthorizationUrl();
        echo '<a href="'.$authUrl.'">Click here to authorize github</a>';
    }
    

<?php

class GitHubClient extends xPDOObject {
   
   public function makeAPIRequest(){
       $token = $this->get('token');
       $this->GET();
   }
}

/** ====== OR ======= **/

class GitHubClient {

   public function makeAPIRequest(){
       $tokenObj = $this->modx->getObject('OAuthToken');
       $token = $tokenObj->getToken();
       $this->GET();
   }

}

<?php
class BaseClassName extends xPDOObject {

}


class GitHubClient extends BaseClassName {
    
   public function makeAPIRequest(){
       $token = $this->get('token');
       $this->GET();
   }
}