(20250825) -Added new google places API Integration system, no more oauth system for places api integration,

added multiple files for and correction and changes as well.

controllers_v2/software/google_places/base.py

@@ -52,20 +52,12 @@ from utils_v2.rest.models.api_call import ApiResponse
 from models.core.user import CoreUserInfoModel
 from models.core.auth_token import CoreAuthTokenModel
 from models.core.user import CoreUserInfoModel
-from models.api.message.mail.oauth import (
-    OAuthMailAuthorizationRequestHeaders,
-    OAuthMailAuthorizationRequestData
-)
-from models.message.mail.oauth import OAuthMailGetAuthorizationURLResponse, OAuthMailHandleCallbackResponse
-from models.core.message import CoreMessageModel
+from models.api.software.places.oauth import PlacesAuthResponse
+
 # To make HTTP requests:
 import httpx
 
-# to work with MongoDB:
-from bson.objectid import ObjectId
 
-# Mail Client(s):
-from utils_v2.goog.controllers.places.places_client import AsyncPlacesClient
 
 # To make abstract classes:
 from abc import ABC, abstractmethod
@@ -173,80 +165,22 @@ class GooglePlacesController(CoreSoftwareController, ABC):
             debug_only_errors = debug_only_errors
         )
 
-    # ┏┓┏┓   ┓ ┏┓ ┏┓
-    # ┃┃┣┫┓┏╋┣┓┏┛ ┃┫
-    # ┗┛┛┗┗┻┗┛┗┗━•┗┛
-
     @abstractmethod
-    async def get_authorization_url(
+    async def save_auth(
             self,
             sql_conn: AsyncMySQL,
             mongo_data_conn: AsyncMongo,
-            mail_client: AsyncPlacesClient,
-            user_info: CoreUserInfoModel,
-            inbound_data: OAuthMailAuthorizationRequestData,
+            auth: CoreAuthTokenModel,
+            user: CoreUserInfoModel,
             session_token: str
-    ) -> OAuthMailGetAuthorizationURLResponse:
+    ) -> PlacesAuthResponse:
         """
-        To accept an incoming request for mail integration and provide a URL that the user can use to authorize your
-        service to access his mail inbox.
+        Checks if a particular set of incoming credentials give access to a valid server and then stores the
+        credentials.
         :param sql_conn: The database connection to use to perform this task.
         :param mongo_data_conn: The database connection to use to perform this task.
-        :param mail_client: The instance of the third-party mail client that will be used to get the URL.
-        :param user_info: The information about your user who is trying to use this system.
-        :param inbound_data: The data that came in with the request (API call).
-        :param session_token: The session token of the user.
-        :return: A structure response with details about the URL generation process.
-        """
-
-        pass
-
-    @abstractmethod
-    async def handle_authorization_callback(
-            self,
-            sql_conn: AsyncMySQL,
-            mongo_data_conn: AsyncMongo,
-            mail_client: AsyncPlacesClient,
-            request_url: str,
-            inbound_data: dict,
-            session_token: str = None
-    ) -> OAuthMailHandleCallbackResponse:
-        """
-        To handle the authorization callback for the mail client. The user may grant or deny authorization.
-        :param sql_conn: The database connection to use to perform this task.
-        :param mongo_data_conn: The database connection to use to perform this task.
-        :param mail_client: The instance of the third-party mail client that will be used to get the URL.
-        :param request_url: The full callback URL invoked by the third-party client.
-        :param inbound_data: The data that came in with the request (API call).
-        :param session_token: The session token of the user. It is expected that this will be null in all cases.
-        :return: A structured response of the process of handling the mail callback.
-        """
-
-        pass
-
-    @abstractmethod
-    async def refresh_authorization(
-            self,
-            sql_conn: AsyncMySQL,
-            mongo_data_conn: AsyncMongo,
-            mail_client: AsyncPlacesClient,
-            http_client: httpx.AsyncClient,
-            auth_token: CoreAuthTokenModel,
-            force_refresh: bool = False,
-            session_token: str = None
-    ) -> CoreAuthTokenModel:
-        """
-        To refresh the third-party client's access/authorization token(s) before use.
-        :param sql_conn: The database connection to use when storing the refreshed tokens.
-        :param mongo_data_conn: The database connection to use when storing the refreshed tokens.
-        :param mail_client: The connection of the third-party mail client.
-        :param http_client: The HTTP client to use to make the token refresh request.
-        :param auth_token: The auth-token model of the existing integration. This may get updated if a refresh is needed
-            (or forced).
-        :param force_refresh: Whether, or not, you would like to force a refresh even if the token hasn't expired yet.
-        :param session_token: The session token of the user. This will be null if this method is invoked by a cron
-            script in the background. Needed only to identify the user in case of a failure to send a timely alert.
-        :return: The same auth-token model instance, but maybe with updated tokens.
+        :param auth: The set of credentials as received from the UI/API.
+        :return: A structured response to indicate what happened during authorization.
         """
 
         pass