@blackcode_sa/metaestetics-api 1.15.16 → 1.15.17-staging.1

package/src/services/tier-enforcement.ts

@@ -1,240 +1,240 @@
-import {
-  Firestore,
-  collection,
-  doc,
-  getDoc,
-  getDocs,
-  query,
-  where,
-} from 'firebase/firestore';
-import {
-  CLINIC_GROUPS_COLLECTION,
-  CLINICS_COLLECTION,
-} from '../types/clinic/index';
-import { PRACTITIONERS_COLLECTION } from '../types/practitioner/index';
-import { PROCEDURES_COLLECTION } from '../types/procedure/index';
-import { TIER_CONFIG, resolveEffectiveTier } from '../config/tiers.config';
-
-export class TierLimitError extends Error {
-  public readonly code = 'TIER_LIMIT_EXCEEDED';
-  public readonly currentTier: string;
-  public readonly resource: string;
-  public readonly currentCount: number;
-  public readonly maxAllowed: number;
-
-  constructor(
-    resource: string,
-    currentTier: string,
-    currentCount: number,
-    maxAllowed: number
-  ) {
-    const tierLabel = currentTier.charAt(0).toUpperCase() + currentTier.slice(1);
-    const canBuyAddons = currentTier === 'connect' || currentTier === 'pro';
-    const actionHint = canBuyAddons
-      ? 'Please upgrade your plan or purchase an add-on.'
-      : 'Please upgrade to Connect or Pro to add more.';
-    super(
-      `Your ${tierLabel} plan allows a maximum of ${maxAllowed} ${resource}. ` +
-      `You currently have ${currentCount}. ${actionHint}`
-    );
-    this.name = 'TierLimitError';
-    this.currentTier = currentTier;
-    this.resource = resource;
-    this.currentCount = currentCount;
-    this.maxAllowed = maxAllowed;
-  }
-}
-
-/**
- * Reads the clinic group doc and returns tier + billing data in one call.
- */
-async function getClinicGroupTierData(
-  db: Firestore,
-  clinicGroupId: string
-): Promise<{
-  tier: string;
-  billing: Record<string, any> | undefined;
-}> {
-  const groupRef = doc(db, CLINIC_GROUPS_COLLECTION, clinicGroupId);
-  const groupSnap = await getDoc(groupRef);
-  if (!groupSnap.exists()) {
-    throw new Error(`Clinic group ${clinicGroupId} not found`);
-  }
-  const data = groupSnap.data();
-  const subscriptionModel = data.subscriptionModel || 'no_subscription';
-  return {
-    tier: resolveEffectiveTier(subscriptionModel),
-    billing: data.billing,
-  };
-}
-
-/**
- * Fetches the effective tier for a clinic group.
- */
-export async function getEffectiveTier(
-  db: Firestore,
-  clinicGroupId: string
-): Promise<string> {
-  const { tier } = await getClinicGroupTierData(db, clinicGroupId);
-  return tier;
-}
-
-/**
- * Counts active providers (practitioners) assigned to a specific clinic branch.
- */
-async function countProvidersInBranch(
-  db: Firestore,
-  branchId: string
-): Promise<number> {
-  const practitionersQuery = query(
-    collection(db, PRACTITIONERS_COLLECTION),
-    where('isActive', '==', true)
-  );
-  const practitionersSnap = await getDocs(practitionersQuery);
-
-  return practitionersSnap.docs.filter(d => {
-    const clinics: string[] = d.data().clinics || [];
-    return clinics.includes(branchId);
-  }).length;
-}
-
-/**
- * Counts active procedures for a specific provider in a specific branch.
- * Uses unique technologyId to avoid double-counting same procedure type.
- */
-async function countProceduresForProvider(
-  db: Firestore,
-  branchId: string,
-  providerId: string
-): Promise<number> {
-  const proceduresQuery = query(
-    collection(db, PROCEDURES_COLLECTION),
-    where('clinicBranchId', '==', branchId),
-    where('practitionerId', '==', providerId),
-    where('isActive', '==', true)
-  );
-  const proceduresSnap = await getDocs(proceduresQuery);
-
-  const uniqueTechnologyIds = new Set<string>();
-  proceduresSnap.docs.forEach(d => {
-    const technologyId = d.data().technologyId;
-    if (technologyId) {
-      uniqueTechnologyIds.add(technologyId);
-    }
-  });
-
-  return uniqueTechnologyIds.size;
-}
-
-/**
- * Counts active clinic branches in a clinic group.
- */
-async function countBranchesInGroup(
-  db: Firestore,
-  clinicGroupId: string
-): Promise<number> {
-  const clinicsQuery = query(
-    collection(db, CLINICS_COLLECTION),
-    where('clinicGroupId', '==', clinicGroupId),
-    where('isActive', '==', true)
-  );
-  const clinicsSnap = await getDocs(clinicsQuery);
-  return clinicsSnap.size;
-}
-
-/**
- * Resolves the clinicGroupId for a given branch.
- */
-async function resolveClinicGroupId(
-  db: Firestore,
-  branchId: string
-): Promise<string> {
-  const clinicRef = doc(db, CLINICS_COLLECTION, branchId);
-  const clinicSnap = await getDoc(clinicRef);
-  if (!clinicSnap.exists()) {
-    throw new Error(`Clinic branch ${branchId} not found`);
-  }
-  const clinicGroupId = clinicSnap.data().clinicGroupId;
-  if (!clinicGroupId) {
-    throw new Error(`Clinic branch ${branchId} has no clinicGroupId`);
-  }
-  return clinicGroupId;
-}
-
-/**
- * Enforces tier limit before adding a provider to a specific branch.
- * Add-on aware: effective limit = base + per-branch extraProviders.
- */
-export async function enforceProviderLimit(
-  db: Firestore,
-  clinicGroupId: string,
-  branchId: string
-): Promise<void> {
-  const { tier, billing } = await getClinicGroupTierData(db, clinicGroupId);
-  const config = TIER_CONFIG[tier];
-  if (!config) return;
-
-  const baseMax = config.limits.maxProvidersPerBranch;
-  if (baseMax === -1) return;
-
-  const addOns = billing?.addOns || {};
-  const extraProviders = addOns[branchId]?.extraProviders || 0;
-  const effectiveMax = baseMax + extraProviders;
-
-  const currentCount = await countProvidersInBranch(db, branchId);
-  if (currentCount + 1 > effectiveMax) {
-    throw new TierLimitError('providers in this branch', tier, currentCount, effectiveMax);
-  }
-}
-
-/**
- * Enforces tier limit before creating a procedure for a provider in a branch.
- * Add-on aware: effective limit = base + (procedureBlocks × 5).
- */
-export async function enforceProcedureLimit(
-  db: Firestore,
-  clinicGroupId: string,
-  branchId: string,
-  providerId: string,
-  count: number = 1
-): Promise<void> {
-  const { tier, billing } = await getClinicGroupTierData(db, clinicGroupId);
-  const config = TIER_CONFIG[tier];
-  if (!config) return;
-
-  const baseMax = config.limits.maxProceduresPerProvider;
-  if (baseMax === -1) return;
-
-  const addOns = billing?.addOns || {};
-  const procedureBlocks = addOns[branchId]?.procedureBlocks || 0;
-  const effectiveMax = baseMax + (procedureBlocks * 5);
-
-  const currentCount = await countProceduresForProvider(db, branchId, providerId);
-  if (currentCount + count > effectiveMax) {
-    throw new TierLimitError('procedures for this provider', tier, currentCount, effectiveMax);
-  }
-}
-
-/**
- * Enforces tier limit before creating a clinic branch.
- * Add-on aware: effective limit = base + branchAddonCount.
- */
-export async function enforceBranchLimit(
-  db: Firestore,
-  clinicGroupId: string
-): Promise<void> {
-  const { tier, billing } = await getClinicGroupTierData(db, clinicGroupId);
-  const config = TIER_CONFIG[tier];
-  if (!config) return;
-
-  const baseMax = config.limits.maxBranches;
-  if (baseMax === -1) return;
-
-  const branchAddonCount = billing?.branchAddonCount || 0;
-  const effectiveMax = baseMax + branchAddonCount;
-
-  const currentCount = await countBranchesInGroup(db, clinicGroupId);
-  if (currentCount + 1 > effectiveMax) {
-    throw new TierLimitError('clinic branches', tier, currentCount, effectiveMax);
-  }
-}
+import {
+  Firestore,
+  collection,
+  doc,
+  getDoc,
+  getDocs,
+  query,
+  where,
+} from 'firebase/firestore';
+import {
+  CLINIC_GROUPS_COLLECTION,
+  CLINICS_COLLECTION,
+} from '../types/clinic/index';
+import { PRACTITIONERS_COLLECTION } from '../types/practitioner/index';
+import { PROCEDURES_COLLECTION } from '../types/procedure/index';
+import { TIER_CONFIG, resolveEffectiveTier } from '../config/tiers.config';
+
+export class TierLimitError extends Error {
+  public readonly code = 'TIER_LIMIT_EXCEEDED';
+  public readonly currentTier: string;
+  public readonly resource: string;
+  public readonly currentCount: number;
+  public readonly maxAllowed: number;
+
+  constructor(
+    resource: string,
+    currentTier: string,
+    currentCount: number,
+    maxAllowed: number
+  ) {
+    const tierLabel = currentTier.charAt(0).toUpperCase() + currentTier.slice(1);
+    const canBuyAddons = currentTier === 'connect' || currentTier === 'pro';
+    const actionHint = canBuyAddons
+      ? 'Please upgrade your plan or purchase an add-on.'
+      : 'Please upgrade to Connect or Pro to add more.';
+    super(
+      `Your ${tierLabel} plan allows a maximum of ${maxAllowed} ${resource}. ` +
+      `You currently have ${currentCount}. ${actionHint}`
+    );
+    this.name = 'TierLimitError';
+    this.currentTier = currentTier;
+    this.resource = resource;
+    this.currentCount = currentCount;
+    this.maxAllowed = maxAllowed;
+  }
+}
+
+/**
+ * Reads the clinic group doc and returns tier + billing data in one call.
+ */
+async function getClinicGroupTierData(
+  db: Firestore,
+  clinicGroupId: string
+): Promise<{
+  tier: string;
+  billing: Record<string, any> | undefined;
+}> {
+  const groupRef = doc(db, CLINIC_GROUPS_COLLECTION, clinicGroupId);
+  const groupSnap = await getDoc(groupRef);
+  if (!groupSnap.exists()) {
+    throw new Error(`Clinic group ${clinicGroupId} not found`);
+  }
+  const data = groupSnap.data();
+  const subscriptionModel = data.subscriptionModel || 'no_subscription';
+  return {
+    tier: resolveEffectiveTier(subscriptionModel),
+    billing: data.billing,
+  };
+}
+
+/**
+ * Fetches the effective tier for a clinic group.
+ */
+export async function getEffectiveTier(
+  db: Firestore,
+  clinicGroupId: string
+): Promise<string> {
+  const { tier } = await getClinicGroupTierData(db, clinicGroupId);
+  return tier;
+}
+
+/**
+ * Counts active providers (practitioners) assigned to a specific clinic branch.
+ */
+async function countProvidersInBranch(
+  db: Firestore,
+  branchId: string
+): Promise<number> {
+  const practitionersQuery = query(
+    collection(db, PRACTITIONERS_COLLECTION),
+    where('isActive', '==', true)
+  );
+  const practitionersSnap = await getDocs(practitionersQuery);
+
+  return practitionersSnap.docs.filter(d => {
+    const clinics: string[] = d.data().clinics || [];
+    return clinics.includes(branchId);
+  }).length;
+}
+
+/**
+ * Counts active procedures for a specific provider in a specific branch.
+ * Uses unique technologyId to avoid double-counting same procedure type.
+ */
+async function countProceduresForProvider(
+  db: Firestore,
+  branchId: string,
+  providerId: string
+): Promise<number> {
+  const proceduresQuery = query(
+    collection(db, PROCEDURES_COLLECTION),
+    where('clinicBranchId', '==', branchId),
+    where('practitionerId', '==', providerId),
+    where('isActive', '==', true)
+  );
+  const proceduresSnap = await getDocs(proceduresQuery);
+
+  const uniqueTechnologyIds = new Set<string>();
+  proceduresSnap.docs.forEach(d => {
+    const technologyId = d.data().technologyId;
+    if (technologyId) {
+      uniqueTechnologyIds.add(technologyId);
+    }
+  });
+
+  return uniqueTechnologyIds.size;
+}
+
+/**
+ * Counts active clinic branches in a clinic group.
+ */
+async function countBranchesInGroup(
+  db: Firestore,
+  clinicGroupId: string
+): Promise<number> {
+  const clinicsQuery = query(
+    collection(db, CLINICS_COLLECTION),
+    where('clinicGroupId', '==', clinicGroupId),
+    where('isActive', '==', true)
+  );
+  const clinicsSnap = await getDocs(clinicsQuery);
+  return clinicsSnap.size;
+}
+
+/**
+ * Resolves the clinicGroupId for a given branch.
+ */
+async function resolveClinicGroupId(
+  db: Firestore,
+  branchId: string
+): Promise<string> {
+  const clinicRef = doc(db, CLINICS_COLLECTION, branchId);
+  const clinicSnap = await getDoc(clinicRef);
+  if (!clinicSnap.exists()) {
+    throw new Error(`Clinic branch ${branchId} not found`);
+  }
+  const clinicGroupId = clinicSnap.data().clinicGroupId;
+  if (!clinicGroupId) {
+    throw new Error(`Clinic branch ${branchId} has no clinicGroupId`);
+  }
+  return clinicGroupId;
+}
+
+/**
+ * Enforces tier limit before adding a provider to a specific branch.
+ * Add-on aware: effective limit = base + per-branch extraProviders.
+ */
+export async function enforceProviderLimit(
+  db: Firestore,
+  clinicGroupId: string,
+  branchId: string
+): Promise<void> {
+  const { tier, billing } = await getClinicGroupTierData(db, clinicGroupId);
+  const config = TIER_CONFIG[tier];
+  if (!config) return;
+
+  const baseMax = config.limits.maxProvidersPerBranch;
+  if (baseMax === -1) return;
+
+  const addOns = billing?.addOns || {};
+  const extraProviders = addOns[branchId]?.extraProviders || 0;
+  const effectiveMax = baseMax + extraProviders;
+
+  const currentCount = await countProvidersInBranch(db, branchId);
+  if (currentCount + 1 > effectiveMax) {
+    throw new TierLimitError('providers in this branch', tier, currentCount, effectiveMax);
+  }
+}
+
+/**
+ * Enforces tier limit before creating a procedure for a provider in a branch.
+ * Add-on aware: effective limit = base + (procedureBlocks × 5).
+ */
+export async function enforceProcedureLimit(
+  db: Firestore,
+  clinicGroupId: string,
+  branchId: string,
+  providerId: string,
+  count: number = 1
+): Promise<void> {
+  const { tier, billing } = await getClinicGroupTierData(db, clinicGroupId);
+  const config = TIER_CONFIG[tier];
+  if (!config) return;
+
+  const baseMax = config.limits.maxProceduresPerProvider;
+  if (baseMax === -1) return;
+
+  const addOns = billing?.addOns || {};
+  const procedureBlocks = addOns[branchId]?.procedureBlocks || 0;
+  const effectiveMax = baseMax + (procedureBlocks * 5);
+
+  const currentCount = await countProceduresForProvider(db, branchId, providerId);
+  if (currentCount + count > effectiveMax) {
+    throw new TierLimitError('procedures for this provider', tier, currentCount, effectiveMax);
+  }
+}
+
+/**
+ * Enforces tier limit before creating a clinic branch.
+ * Add-on aware: effective limit = base + branchAddonCount.
+ */
+export async function enforceBranchLimit(
+  db: Firestore,
+  clinicGroupId: string
+): Promise<void> {
+  const { tier, billing } = await getClinicGroupTierData(db, clinicGroupId);
+  const config = TIER_CONFIG[tier];
+  if (!config) return;
+
+  const baseMax = config.limits.maxBranches;
+  if (baseMax === -1) return;
+
+  const branchAddonCount = billing?.branchAddonCount || 0;
+  const effectiveMax = baseMax + branchAddonCount;
+
+  const currentCount = await countBranchesInGroup(db, clinicGroupId);
+  if (currentCount + 1 > effectiveMax) {
+    throw new TierLimitError('clinic branches', tier, currentCount, effectiveMax);
+  }
+}

package/src/services/user/index.ts

@@ -1 +1 @@
-export * from "./user.service";
+export * from "./user.service";