@blackcode_sa/metaestetics-api 1.15.14 → 1.15.17-staging.0

package/src/services/clinic/billing-transactions.service.ts

@@ -1,217 +1,217 @@
-import {
-  collection,
-  getDocs,
-  query,
-  orderBy,
-  limit,
-  startAfter,
-  where,
-  DocumentSnapshot,
-  QueryConstraint,
-} from 'firebase/firestore';
-import { BaseService } from '../base.service';
-import {
-  BillingTransaction,
-  BillingTransactionType,
-  CLINIC_GROUPS_COLLECTION,
-} from '../../types/clinic';
-
-/**
- * Service for managing billing transactions
- * Provides read-only access to billing transaction history
- */
-export class BillingTransactionsService extends BaseService {
-  private readonly BILLING_TRANSACTIONS_COLLECTION = 'billingTransactions';
-
-  /**
-   * Get billing transactions for a clinic group with pagination
-   * @param clinicGroupId - The clinic group ID
-   * @param options - Query options
-   * @returns Promise with transactions and pagination info
-   */
-  async getBillingTransactions(
-    clinicGroupId: string,
-    options: {
-      limit?: number;
-      startAfter?: DocumentSnapshot;
-      transactionType?: BillingTransactionType;
-    } = {},
-  ): Promise<{
-    transactions: BillingTransaction[];
-    lastDoc: DocumentSnapshot | null;
-    hasMore: boolean;
-  }> {
-    try {
-      const { limit: queryLimit = 50, startAfter: startAfterDoc, transactionType } = options;
-
-      // Build query constraints
-      const constraints: QueryConstraint[] = [];
-
-      // Add transaction type filter if specified
-      if (transactionType) {
-        constraints.push(where('type', '==', transactionType));
-      }
-
-      // Add ordering
-      constraints.push(orderBy('timestamp', 'desc')); // Most recent first
-
-      // Add pagination
-      if (startAfterDoc) {
-        constraints.push(startAfter(startAfterDoc));
-      }
-
-      constraints.push(limit(queryLimit + 1)); // Get one extra to check if there are more
-
-      // Execute query
-      const transactionsRef = collection(
-        this.db,
-        CLINIC_GROUPS_COLLECTION,
-        clinicGroupId,
-        this.BILLING_TRANSACTIONS_COLLECTION,
-      );
-
-      const q = query(transactionsRef, ...constraints);
-      const querySnapshot = await getDocs(q);
-
-      // Process results
-      const docs = querySnapshot.docs;
-      const hasMore = docs.length > queryLimit;
-      const transactions = docs.slice(0, queryLimit).map(doc => ({
-        id: doc.id,
-        ...doc.data(),
-      })) as BillingTransaction[];
-
-      const lastDoc = transactions.length > 0 ? docs[transactions.length - 1] : null;
-
-      return {
-        transactions,
-        lastDoc,
-        hasMore,
-      };
-    } catch (error) {
-      console.error(
-        `Error fetching billing transactions for clinic group ${clinicGroupId}:`,
-        error,
-      );
-      throw new Error(
-        `Failed to fetch billing transactions: ${
-          error instanceof Error ? error.message : 'Unknown error'
-        }`,
-      );
-    }
-  }
-
-  /**
-   * Get recent billing transactions (last 10)
-   * @param clinicGroupId - The clinic group ID
-   * @returns Promise with recent transactions
-   */
-  async getRecentBillingTransactions(clinicGroupId: string): Promise<BillingTransaction[]> {
-    const result = await this.getBillingTransactions(clinicGroupId, { limit: 10 });
-    return result.transactions;
-  }
-
-  /**
-   * Get billing transactions by type
-   * @param clinicGroupId - The clinic group ID
-   * @param transactionType - The transaction type to filter by
-   * @param options - Additional query options
-   * @returns Promise with filtered transactions
-   */
-  async getBillingTransactionsByType(
-    clinicGroupId: string,
-    transactionType: BillingTransactionType,
-    options: {
-      limit?: number;
-      startAfter?: DocumentSnapshot;
-    } = {},
-  ): Promise<{
-    transactions: BillingTransaction[];
-    lastDoc: DocumentSnapshot | null;
-    hasMore: boolean;
-  }> {
-    return this.getBillingTransactions(clinicGroupId, {
-      ...options,
-      transactionType,
-    });
-  }
-
-  /**
-   * Get subscription-related transactions only
-   * @param clinicGroupId - The clinic group ID
-   * @param options - Query options
-   * @returns Promise with subscription transactions
-   */
-  async getSubscriptionTransactions(
-    clinicGroupId: string,
-    options: {
-      limit?: number;
-      startAfter?: DocumentSnapshot;
-    } = {},
-  ): Promise<{
-    transactions: BillingTransaction[];
-    lastDoc: DocumentSnapshot | null;
-    hasMore: boolean;
-  }> {
-    try {
-      const { limit: queryLimit = 50, startAfter: startAfterDoc } = options;
-
-      // Subscription-related transaction types
-      const subscriptionTypes = [
-        BillingTransactionType.SUBSCRIPTION_CREATED,
-        BillingTransactionType.SUBSCRIPTION_ACTIVATED,
-        BillingTransactionType.SUBSCRIPTION_RENEWED,
-        BillingTransactionType.SUBSCRIPTION_UPDATED,
-        BillingTransactionType.SUBSCRIPTION_CANCELED,
-        BillingTransactionType.SUBSCRIPTION_REACTIVATED,
-        BillingTransactionType.SUBSCRIPTION_DELETED,
-      ];
-
-      const constraints: QueryConstraint[] = [
-        where('type', 'in', subscriptionTypes),
-        orderBy('timestamp', 'desc'),
-      ];
-
-      if (startAfterDoc) {
-        constraints.push(startAfter(startAfterDoc));
-      }
-
-      constraints.push(limit(queryLimit + 1));
-
-      const transactionsRef = collection(
-        this.db,
-        CLINIC_GROUPS_COLLECTION,
-        clinicGroupId,
-        this.BILLING_TRANSACTIONS_COLLECTION,
-      );
-
-      const q = query(transactionsRef, ...constraints);
-      const querySnapshot = await getDocs(q);
-
-      const docs = querySnapshot.docs;
-      const hasMore = docs.length > queryLimit;
-      const transactions = docs.slice(0, queryLimit).map(doc => ({
-        id: doc.id,
-        ...doc.data(),
-      })) as BillingTransaction[];
-
-      const lastDoc = transactions.length > 0 ? docs[transactions.length - 1] : null;
-
-      return {
-        transactions,
-        lastDoc,
-        hasMore,
-      };
-    } catch (error) {
-      console.error(
-        `Error fetching subscription transactions for clinic group ${clinicGroupId}:`,
-        error,
-      );
-      throw new Error(
-        `Failed to fetch subscription transactions: ${
-          error instanceof Error ? error.message : 'Unknown error'
-        }`,
-      );
-    }
-  }
-}
+import {
+  collection,
+  getDocs,
+  query,
+  orderBy,
+  limit,
+  startAfter,
+  where,
+  DocumentSnapshot,
+  QueryConstraint,
+} from 'firebase/firestore';
+import { BaseService } from '../base.service';
+import {
+  BillingTransaction,
+  BillingTransactionType,
+  CLINIC_GROUPS_COLLECTION,
+} from '../../types/clinic';
+
+/**
+ * Service for managing billing transactions
+ * Provides read-only access to billing transaction history
+ */
+export class BillingTransactionsService extends BaseService {
+  private readonly BILLING_TRANSACTIONS_COLLECTION = 'billingTransactions';
+
+  /**
+   * Get billing transactions for a clinic group with pagination
+   * @param clinicGroupId - The clinic group ID
+   * @param options - Query options
+   * @returns Promise with transactions and pagination info
+   */
+  async getBillingTransactions(
+    clinicGroupId: string,
+    options: {
+      limit?: number;
+      startAfter?: DocumentSnapshot;
+      transactionType?: BillingTransactionType;
+    } = {},
+  ): Promise<{
+    transactions: BillingTransaction[];
+    lastDoc: DocumentSnapshot | null;
+    hasMore: boolean;
+  }> {
+    try {
+      const { limit: queryLimit = 50, startAfter: startAfterDoc, transactionType } = options;
+
+      // Build query constraints
+      const constraints: QueryConstraint[] = [];
+
+      // Add transaction type filter if specified
+      if (transactionType) {
+        constraints.push(where('type', '==', transactionType));
+      }
+
+      // Add ordering
+      constraints.push(orderBy('timestamp', 'desc')); // Most recent first
+
+      // Add pagination
+      if (startAfterDoc) {
+        constraints.push(startAfter(startAfterDoc));
+      }
+
+      constraints.push(limit(queryLimit + 1)); // Get one extra to check if there are more
+
+      // Execute query
+      const transactionsRef = collection(
+        this.db,
+        CLINIC_GROUPS_COLLECTION,
+        clinicGroupId,
+        this.BILLING_TRANSACTIONS_COLLECTION,
+      );
+
+      const q = query(transactionsRef, ...constraints);
+      const querySnapshot = await getDocs(q);
+
+      // Process results
+      const docs = querySnapshot.docs;
+      const hasMore = docs.length > queryLimit;
+      const transactions = docs.slice(0, queryLimit).map(doc => ({
+        id: doc.id,
+        ...doc.data(),
+      })) as BillingTransaction[];
+
+      const lastDoc = transactions.length > 0 ? docs[transactions.length - 1] : null;
+
+      return {
+        transactions,
+        lastDoc,
+        hasMore,
+      };
+    } catch (error) {
+      console.error(
+        `Error fetching billing transactions for clinic group ${clinicGroupId}:`,
+        error,
+      );
+      throw new Error(
+        `Failed to fetch billing transactions: ${
+          error instanceof Error ? error.message : 'Unknown error'
+        }`,
+      );
+    }
+  }
+
+  /**
+   * Get recent billing transactions (last 10)
+   * @param clinicGroupId - The clinic group ID
+   * @returns Promise with recent transactions
+   */
+  async getRecentBillingTransactions(clinicGroupId: string): Promise<BillingTransaction[]> {
+    const result = await this.getBillingTransactions(clinicGroupId, { limit: 10 });
+    return result.transactions;
+  }
+
+  /**
+   * Get billing transactions by type
+   * @param clinicGroupId - The clinic group ID
+   * @param transactionType - The transaction type to filter by
+   * @param options - Additional query options
+   * @returns Promise with filtered transactions
+   */
+  async getBillingTransactionsByType(
+    clinicGroupId: string,
+    transactionType: BillingTransactionType,
+    options: {
+      limit?: number;
+      startAfter?: DocumentSnapshot;
+    } = {},
+  ): Promise<{
+    transactions: BillingTransaction[];
+    lastDoc: DocumentSnapshot | null;
+    hasMore: boolean;
+  }> {
+    return this.getBillingTransactions(clinicGroupId, {
+      ...options,
+      transactionType,
+    });
+  }
+
+  /**
+   * Get subscription-related transactions only
+   * @param clinicGroupId - The clinic group ID
+   * @param options - Query options
+   * @returns Promise with subscription transactions
+   */
+  async getSubscriptionTransactions(
+    clinicGroupId: string,
+    options: {
+      limit?: number;
+      startAfter?: DocumentSnapshot;
+    } = {},
+  ): Promise<{
+    transactions: BillingTransaction[];
+    lastDoc: DocumentSnapshot | null;
+    hasMore: boolean;
+  }> {
+    try {
+      const { limit: queryLimit = 50, startAfter: startAfterDoc } = options;
+
+      // Subscription-related transaction types
+      const subscriptionTypes = [
+        BillingTransactionType.SUBSCRIPTION_CREATED,
+        BillingTransactionType.SUBSCRIPTION_ACTIVATED,
+        BillingTransactionType.SUBSCRIPTION_RENEWED,
+        BillingTransactionType.SUBSCRIPTION_UPDATED,
+        BillingTransactionType.SUBSCRIPTION_CANCELED,
+        BillingTransactionType.SUBSCRIPTION_REACTIVATED,
+        BillingTransactionType.SUBSCRIPTION_DELETED,
+      ];
+
+      const constraints: QueryConstraint[] = [
+        where('type', 'in', subscriptionTypes),
+        orderBy('timestamp', 'desc'),
+      ];
+
+      if (startAfterDoc) {
+        constraints.push(startAfter(startAfterDoc));
+      }
+
+      constraints.push(limit(queryLimit + 1));
+
+      const transactionsRef = collection(
+        this.db,
+        CLINIC_GROUPS_COLLECTION,
+        clinicGroupId,
+        this.BILLING_TRANSACTIONS_COLLECTION,
+      );
+
+      const q = query(transactionsRef, ...constraints);
+      const querySnapshot = await getDocs(q);
+
+      const docs = querySnapshot.docs;
+      const hasMore = docs.length > queryLimit;
+      const transactions = docs.slice(0, queryLimit).map(doc => ({
+        id: doc.id,
+        ...doc.data(),
+      })) as BillingTransaction[];
+
+      const lastDoc = transactions.length > 0 ? docs[transactions.length - 1] : null;
+
+      return {
+        transactions,
+        lastDoc,
+        hasMore,
+      };
+    } catch (error) {
+      console.error(
+        `Error fetching subscription transactions for clinic group ${clinicGroupId}:`,
+        error,
+      );
+      throw new Error(
+        `Failed to fetch subscription transactions: ${
+          error instanceof Error ? error.message : 'Unknown error'
+        }`,
+      );
+    }
+  }
+}