Issue 9 configure google calendar integration

.gitignore

@@ -295,3 +295,6 @@ dist
 pyrightconfig.json
 
 opt/
+
+# google api 
+server/api/booking/google_calendar/google_calendar_service.json

server/.env.example

@@ -19,4 +19,9 @@ AWS_SECRET_ACCESS_KEY=xxxx
 AWS_STORAGE_BUCKET_NAME=bucket_name
 AWS_REGION_NAME=ap-southeast-2
 
+# Google API
+GOOGLE_CREDENTIALS_FILE=server/api/booking/google_calendar/template_service_account.json
+GOOGLE_CALENDAR_ID=xxxx
+
+
 FRONTEND_URL="http://localhost:3000"

server/api/booking/google_calendar/client.py

@@ -0,0 +1,29 @@
+import os
+from pathlib import Path
+from google.oauth2 import service_account
+from googleapiclient.discovery import build
+from dotenv import load_dotenv
+
+
+# Resolve BASE_DIR and load .env
+# adjust to server root
+BASE_DIR = Path(__file__).resolve().parent.parent.parent.parent
+load_dotenv(os.path.join(BASE_DIR, ".env"))
+
+cred_path = os.getenv("GOOGLE_CREDENTIALS_FILE")
+calendar_id = os.getenv("GOOGLE_CALENDAR_ID")
+
+
+def get_calendar_service():
+
+    if not cred_path:
+        raise FileNotFoundError(
+            "GOOGLE_CREDENTIALS_FILE is missing or invalid. "
+            f"Checked: {os.path.join(BASE_DIR, '.env')}"
+        )
+
+    creds = service_account.Credentials.from_service_account_file(
+        cred_path,
+        scopes=["https://www.googleapis.com/auth/calendar"]
+    )
+    return build("calendar", "v3", credentials=creds)

server/api/booking/google_calendar/events.py

@@ -0,0 +1,87 @@
+import os
+from .client import get_calendar_service
+
+CALENDAR_ID = os.getenv("GOOGLE_CALENDAR_ID")
+
+
+def create_event(event_data: dict):
+    """
+    Create a new Google Calendar event.
+
+    **Expected event_data keys (Google Calendar API format):**
+    - summary (str): Title of the event.
+    - description (str, optional): Details about the event.
+    - location (str, optional): Physical or virtual location.
+    - start (dict): Start date/time.
+        Example:
+        {
+            "dateTime": "2025-02-01T10:00:00+08:00",
+            "timeZone": "Australia/Perth"
+        }
+    - end (dict): End date/time.
+        Example:
+        {
+            "dateTime": "2025-02-01T11:00:00+08:00",
+            "timeZone": "Australia/Perth"
+        }
+    Returns:
+        dict: The created event object from Google Calendar.
+    """
+    if not CALENDAR_ID:
+        raise ValueError(
+            "GOOGLE_CALENDAR_ID is missing. Set it in your environment.")
+
+    service = get_calendar_service()
+    return service.events().insert(calendarId=CALENDAR_ID, body=event_data).execute()
+
+
+def get_event(event_id: str):
+    """
+    Retrieve a specific event.
+
+    Args:
+        event_id (str): Google Calendar event ID.
+
+    Returns:
+        dict: Event details.
+    """
+    if not CALENDAR_ID:
+        raise ValueError(
+            "GOOGLE_CALENDAR_ID is missing. Set it in your environment.")
+    service = get_calendar_service()
+    return service.events().get(calendarId=CALENDAR_ID, eventId=event_id).execute()
+
+
+def update_event(event_id: str, updated_data: dict):
+    """
+    Update an existing event.
+
+    Args:
+        event_id (str): Google Calendar event ID.
+        updated_data (dict): Same structure as event_data.
+
+    Returns:
+        dict: Updated event object.
+    """
+    if not CALENDAR_ID:
+        raise ValueError(
+            "GOOGLE_CALENDAR_ID is missing. Set it in your environment.")
+    service = get_calendar_service()
+    return service.events().update(calendarId=CALENDAR_ID, eventId=event_id, body=updated_data).execute()
+
+
+def delete_event(event_id: str):
+    """
+    Delete an event.
+
+    Args:
+        event_id (str): Google Calendar event ID.
+
+    Returns:
+        dict: Response from Google Calendar API (usually empty).
+    """
+    if not CALENDAR_ID:
+        raise ValueError(
+            "GOOGLE_CALENDAR_ID is missing. Set it in your environment.")
+    service = get_calendar_service()
+    return service.events().delete(calendarId=CALENDAR_ID, eventId=event_id).execute()

server/api/booking/google_calendar/template_service_account.json

@@ -0,0 +1,8 @@
+{
+  "type": "service_account",
+  "project_id": "xxx",
+  "private_key_id": "xxx",
+  "private_key": "-----BEGIN PRIVATE KEY-----\nxxx\n-----END PRIVATE KEY-----\n",
+  "client_email": "[email protected]",
+  "client_id": "xxx"
+}

server/api/booking/google_calendar/test_google_calendar.py

@@ -0,0 +1,44 @@
+import pytest
+import os
+from api.booking.google_calendar.events import (
+    create_event,
+    get_event,
+    update_event,
+    delete_event,
+)
+# skip if no Google Calendar env variables are set
+pytestmark = pytest.mark.skipif(
+    not os.getenv("GOOGLE_CREDENTIALS_FILE") or not os.getenv(
+        "GOOGLE_CALENDAR_ID"),
+    reason="Google Calendar integration env vars missing. Set GOOGLE_CREDENTIALS_FILE and GOOGLE_CALENDAR_ID to run this test."
+)
+
+
+def test_google_calendar_crud():
+
+    event_data = {
+        "summary": "Test Event",
+        "description": "CRUD test event",
+        "start": {
+            "dateTime": "2025-12-2T15:00:00",
+            "timeZone": "Australia/Perth",
+        },
+        "end": {
+            "dateTime": "2025-12-2T16:00:00",
+            "timeZone": "Australia/Perth",
+        },
+    }
+
+    created = create_event(event_data)
+    event_id = created["id"]
+
+    fetched = get_event(event_id)
+    assert fetched["summary"] == "Test Event"
+
+    updated_data = dict(event_data)
+    updated_data["summary"] = "Updated Test Event"
+
+    updated = update_event(event_id, updated_data)
+    assert updated["summary"] == "Updated Test Event"
+
+    delete_event(event_id)