(20241205) Working on clientUserId (how the third-party client recognizes your user).

api/blueprints/sms/auth.py

@@ -67,10 +67,7 @@ from utils_v2.sms.savvy_bulk_sms.async_savvy_bulk_sms import AsyncSavvyBulkSMS
 from shared import constants
 
 # Data Models:
-from models.data.mail.oauth import (
-    OAuthMailAuthorizationRequestHeaders,
-    OAuthMailAuthorizationRequestData
-)
+from models.data.sms.auth import SMSAuthRequestHeaders, SMSAuthRequestData
 
 # For asynchronous activities:
 import asyncio
@@ -131,22 +128,19 @@ def init(blueprint_setup_state):
 @log_chain_to_mongo(attr_name = "logs_mongo")
 @should_not_be_under_maintenance(attr_name = "is_under_maintenance")
 @validate_input(
-    header_validator = lambda x: OAuthMailAuthorizationRequestHeaders(**x).model_dump(),
-    data_validator = lambda x: OAuthMailAuthorizationRequestData(**x)
+    header_validator = lambda x: SMSAuthRequestHeaders(**x).model_dump(),
+    data_validator = lambda x: SMSAuthRequestData(**{"client": x})
 )
 @handle_cancelled_request()
 async def request_oauth_authorization_url(
-        inbound_headers: dict | OAuthMailAuthorizationRequestHeaders = None,
-        inbound_data: dict | OAuthMailAuthorizationRequestData = None,
+        inbound_headers: dict | SMSAuthRequestHeaders = None,
+        inbound_data: dict | SMSAuthRequestData = None,
         inbound_files: dict = None,
         **kwargs
 ):
 
     """
-    Use this when requesting access to someone's GMail account. This API should be used from the UI. A button click
-    "Connect to GMail" should hit this API, which will generate a request to gain access to the user's GMail account.
-    When the URL is hit, it opens Google's own UI, and, when the user clicks "Continue", Google hits your 'redirect_url'
-    to inform you about the user's action.
+    Use this when a user wants to register a third-party SMS client with your service.
     :param inbound_headers: auto-extracted by the decorators.
     :param inbound_data: auto-extracted by the decorators.
     :param inbound_files: auto-extracted by the decorators.
@@ -167,7 +161,7 @@ async def request_oauth_authorization_url(
         )
 
     # Start by assuming failure:
-    auth_url = None
+    auth_success = None
 
     # ┳ ┓     •┏    ┳┳
     # ┃┏┫┏┓┏┓╋┓╋┓┏  ┃┃┏┏┓┏┓