@blackcode_sa/metaestetics-api 1.13.4 → 1.13.5

package/src/services/calendar/externalCalendar.service.ts

@@ -1,178 +1,178 @@
-import { Auth } from "firebase/auth";
-import { Firestore } from "firebase/firestore";
-import { FirebaseApp } from "firebase/app";
-import { BaseService } from "../base.service";
-
-/**
- * IMPORTANT: This URL should be loaded from an environment configuration
- * (e.g., .env file) and should point to your deployed `externalCalendarApi`
- * Cloud Function.
- */
-const EXTERNAL_CALENDAR_API_BASE_URL =
-  "https://europe-west6-your-project-id.cloudfunctions.net/externalCalendarApi";
-
-/**
- * Interface for the `generateAuthUrl` endpoint response.
- */
-interface GenerateAuthUrlResponse {
-  success: boolean;
-  authUrl?: string;
-  error?: string;
-}
-
-/**
- * Interface for a generic API response for success/error status.
- */
-interface ApiResponse {
-  success: boolean;
-  error?: string;
-  [key: string]: any;
-}
-
-/**
- * Interface for the `getConnectionStatus` endpoint response.
- */
-interface ConnectionStatusResponse {
-  success: boolean;
-  isConnected: boolean;
-  connectionDetails?: {
-    syncStatus: string;
-    calendarId?: string;
-  };
-  error?: string;
-}
-
-/**
- * External Calendar Service
- *
- * This service acts as a client-side wrapper (SDK) for the `externalCalendarApi`
- * Firebase Cloud Function. It handles making authenticated HTTP requests from the
- * frontend applications (web, mobile) to the backend, ensuring that no sensitive
- * logic resides on the client.
- */
-export class ExternalCalendarService extends BaseService {
-  /**
-   * Creates a new ExternalCalendarService instance.
-   * @param db - Firestore instance.
-   * @param auth - Firebase Auth instance.
-   * @param app - Firebase App instance.
-   */
-  constructor(db: Firestore, auth: Auth, app: FirebaseApp) {
-    super(db, auth, app);
-  }
-
-  /**
-   * A private helper method to make authenticated calls to our backend API.
-   * @param endpoint - The API endpoint to call (e.g., '/generateAuthUrl').
-   * @param body - The JSON body for the request.
-   * @returns A promise that resolves to the JSON response from the API.
-   * @throws An error if the user is not authenticated or the network request fails.
-   */
-  private async callApi<T>(endpoint: string, body: object): Promise<T> {
-    if (!this.auth.currentUser) {
-      throw new Error("User not authenticated. Cannot call API.");
-    }
-
-    const idToken = await this.auth.currentUser.getIdToken();
-    const url = `${EXTERNAL_CALENDAR_API_BASE_URL}${endpoint}`;
-
-    const response = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${idToken}`,
-      },
-      body: JSON.stringify(body),
-    });
-
-    if (!response.ok) {
-      const errorBody = await response
-        .json()
-        .catch(() => ({ error: "A network error occurred." }));
-      throw new Error(
-        errorBody.error || `HTTP error! status: ${response.status}`
-      );
-    }
-
-    return response.json() as Promise<T>;
-  }
-
-  /**
-   * Requests an authorization URL from the backend to initiate the Google Calendar connection.
-   * This is the first step in the OAuth flow.
-   *
-   * @param entityType - The type of entity connecting the calendar ('practitioner', 'clinic', or 'patient').
-   * @param entityId - The unique ID of the entity.
-   * @param platform - The platform initiating the request ('web', 'ios', 'android').
-   * @returns The Google OAuth 2.0 URL to which the user should be redirected.
-   * @throws An error if the API call fails to return a valid URL.
-   */
-  async generateAuthUrl(
-    entityType: "practitioner" | "clinic" | "patient",
-    entityId: string,
-    platform: "web" | "ios" | "android"
-  ): Promise<string> {
-    const response = await this.callApi<GenerateAuthUrlResponse>(
-      "/generateAuthUrl",
-      {
-        entityType,
-        entityId,
-        platform,
-      }
-    );
-
-    if (!response.success || !response.authUrl) {
-      throw new Error(
-        response.error || "Failed to generate authentication URL."
-      );
-    }
-
-    return response.authUrl;
-  }
-
-  /**
-   * Sends a request to the backend to disconnect a Google Calendar from an entity.
-   * This will revoke the tokens and remove the sync data from Firestore.
-   *
-   * @param entityType - The type of entity to disconnect.
-   * @param entityId - The ID of the entity.
-   * @returns A promise that resolves when the operation is successful.
-   * @throws An error if the API call fails.
-   */
-  async disconnectCalendar(
-    entityType: "practitioner" | "clinic" | "patient",
-    entityId: string
-  ): Promise<void> {
-    const response = await this.callApi<ApiResponse>("/disconnect", {
-      entityType,
-      entityId,
-    });
-
-    if (!response.success) {
-      throw new Error(response.error || "Failed to disconnect calendar.");
-    }
-  }
-
-  /**
-   * Gets the connection status of an entity's Google Calendar.
-   * This is useful for UI to determine whether to show a 'Connect' or 'Disconnect' button.
-   *
-   * @param entityType - The type of entity to check.
-   * @param entityId - The ID of the entity.
-   * @returns An object containing the connection status and details.
-   */
-  async getCalendarConnectionStatus(
-    entityType: "practitioner" | "clinic" | "patient",
-    entityId: string
-  ): Promise<ConnectionStatusResponse> {
-    const response = await this.callApi<ConnectionStatusResponse>(
-      "/getConnectionStatus",
-      {
-        entityType,
-        entityId,
-      }
-    );
-
-    return response;
-  }
-}
+import { Auth } from "firebase/auth";
+import { Firestore } from "firebase/firestore";
+import { FirebaseApp } from "firebase/app";
+import { BaseService } from "../base.service";
+
+/**
+ * IMPORTANT: This URL should be loaded from an environment configuration
+ * (e.g., .env file) and should point to your deployed `externalCalendarApi`
+ * Cloud Function.
+ */
+const EXTERNAL_CALENDAR_API_BASE_URL =
+  "https://europe-west6-your-project-id.cloudfunctions.net/externalCalendarApi";
+
+/**
+ * Interface for the `generateAuthUrl` endpoint response.
+ */
+interface GenerateAuthUrlResponse {
+  success: boolean;
+  authUrl?: string;
+  error?: string;
+}
+
+/**
+ * Interface for a generic API response for success/error status.
+ */
+interface ApiResponse {
+  success: boolean;
+  error?: string;
+  [key: string]: any;
+}
+
+/**
+ * Interface for the `getConnectionStatus` endpoint response.
+ */
+interface ConnectionStatusResponse {
+  success: boolean;
+  isConnected: boolean;
+  connectionDetails?: {
+    syncStatus: string;
+    calendarId?: string;
+  };
+  error?: string;
+}
+
+/**
+ * External Calendar Service
+ *
+ * This service acts as a client-side wrapper (SDK) for the `externalCalendarApi`
+ * Firebase Cloud Function. It handles making authenticated HTTP requests from the
+ * frontend applications (web, mobile) to the backend, ensuring that no sensitive
+ * logic resides on the client.
+ */
+export class ExternalCalendarService extends BaseService {
+  /**
+   * Creates a new ExternalCalendarService instance.
+   * @param db - Firestore instance.
+   * @param auth - Firebase Auth instance.
+   * @param app - Firebase App instance.
+   */
+  constructor(db: Firestore, auth: Auth, app: FirebaseApp) {
+    super(db, auth, app);
+  }
+
+  /**
+   * A private helper method to make authenticated calls to our backend API.
+   * @param endpoint - The API endpoint to call (e.g., '/generateAuthUrl').
+   * @param body - The JSON body for the request.
+   * @returns A promise that resolves to the JSON response from the API.
+   * @throws An error if the user is not authenticated or the network request fails.
+   */
+  private async callApi<T>(endpoint: string, body: object): Promise<T> {
+    if (!this.auth.currentUser) {
+      throw new Error("User not authenticated. Cannot call API.");
+    }
+
+    const idToken = await this.auth.currentUser.getIdToken();
+    const url = `${EXTERNAL_CALENDAR_API_BASE_URL}${endpoint}`;
+
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${idToken}`,
+      },
+      body: JSON.stringify(body),
+    });
+
+    if (!response.ok) {
+      const errorBody = await response
+        .json()
+        .catch(() => ({ error: "A network error occurred." }));
+      throw new Error(
+        errorBody.error || `HTTP error! status: ${response.status}`
+      );
+    }
+
+    return response.json() as Promise<T>;
+  }
+
+  /**
+   * Requests an authorization URL from the backend to initiate the Google Calendar connection.
+   * This is the first step in the OAuth flow.
+   *
+   * @param entityType - The type of entity connecting the calendar ('practitioner', 'clinic', or 'patient').
+   * @param entityId - The unique ID of the entity.
+   * @param platform - The platform initiating the request ('web', 'ios', 'android').
+   * @returns The Google OAuth 2.0 URL to which the user should be redirected.
+   * @throws An error if the API call fails to return a valid URL.
+   */
+  async generateAuthUrl(
+    entityType: "practitioner" | "clinic" | "patient",
+    entityId: string,
+    platform: "web" | "ios" | "android"
+  ): Promise<string> {
+    const response = await this.callApi<GenerateAuthUrlResponse>(
+      "/generateAuthUrl",
+      {
+        entityType,
+        entityId,
+        platform,
+      }
+    );
+
+    if (!response.success || !response.authUrl) {
+      throw new Error(
+        response.error || "Failed to generate authentication URL."
+      );
+    }
+
+    return response.authUrl;
+  }
+
+  /**
+   * Sends a request to the backend to disconnect a Google Calendar from an entity.
+   * This will revoke the tokens and remove the sync data from Firestore.
+   *
+   * @param entityType - The type of entity to disconnect.
+   * @param entityId - The ID of the entity.
+   * @returns A promise that resolves when the operation is successful.
+   * @throws An error if the API call fails.
+   */
+  async disconnectCalendar(
+    entityType: "practitioner" | "clinic" | "patient",
+    entityId: string
+  ): Promise<void> {
+    const response = await this.callApi<ApiResponse>("/disconnect", {
+      entityType,
+      entityId,
+    });
+
+    if (!response.success) {
+      throw new Error(response.error || "Failed to disconnect calendar.");
+    }
+  }
+
+  /**
+   * Gets the connection status of an entity's Google Calendar.
+   * This is useful for UI to determine whether to show a 'Connect' or 'Disconnect' button.
+   *
+   * @param entityType - The type of entity to check.
+   * @param entityId - The ID of the entity.
+   * @returns An object containing the connection status and details.
+   */
+  async getCalendarConnectionStatus(
+    entityType: "practitioner" | "clinic" | "patient",
+    entityId: string
+  ): Promise<ConnectionStatusResponse> {
+    const response = await this.callApi<ConnectionStatusResponse>(
+      "/getConnectionStatus",
+      {
+        entityType,
+        entityId,
+      }
+    );
+
+    return response;
+  }
+}

package/src/services/calendar/index.ts

@@ -1,5 +1,5 @@
-// export * from "./calendar.service";
-export * from "./calendar.v2.service";
-export * from "./calendar.v3.service";
-export * from "./externalCalendar.service";
-export * from "./synced-calendars.service";
+// export * from "./calendar.service";
+export * from "./calendar.v2.service";
+export * from "./calendar.v3.service";
+export * from "./externalCalendar.service";
+export * from "./synced-calendars.service";