@blackcode_sa/metaestetics-api 1.11.3 → 1.12.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blackcode_sa/metaestetics-api",
   "private": false,
-  "version": "1.11.3",
+  "version": "1.12.0",
   "description": "Firebase authentication service with anonymous upgrade support",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/backoffice/expo-safe/index.ts

@@ -10,6 +10,7 @@ export { CategoryService } from "../services/category.service";
 export { SubcategoryService } from "../services/subcategory.service";
 export { TechnologyService } from "../services/technology.service";
 export { ProductService } from "../services/product.service";
+export { ConstantsService } from "../services/constants.service";
 
 // Backoffice types
 export type { Brand } from "../types/brand.types";
@@ -34,4 +35,6 @@ export {
 export { Contraindication } from "../types/static/contraindication.types";
 export { ProcedureFamily } from "../types/static/procedure-family.types";
 export { TreatmentBenefit } from "../types/static/treatment-benefit.types";
+export { TreatmentBenefitDynamic } from "../types/";
+export { ContraindicationDynamic } from "../types/";
 export { RequirementType, TimeUnit } from "../types/requirement.types";

package/src/backoffice/services/README.md

@@ -0,0 +1,40 @@
+# Backoffice Services
+
+This directory contains services used by the backoffice application.
+
+## Services
+
+### `CategoryService`
+
+Manages procedure categories. Categories are the first level of organization after procedure family (aesthetics/surgery).
+
+- **`create(category)`**: Creates a new category.
+- **`getAll()`**: Retrieves all active categories.
+- **`getAllByFamily(family)`**: Retrieves all active categories for a specific procedure family.
+- **`update(id, category)`**: Updates an existing category.
+- **`delete(id)`**: Soft deletes a category.
+- **`getById(id)`**: Retrieves a category by its ID.
+
+### `ProductService`
+
+Manages products, which are sub-items of a `Technology`.
+
+- **`create(technologyId, brandId, product)`**: Creates a new product under a technology.
+- **`getAllByTechnology(technologyId)`**: Retrieves all products for a technology.
+- **`getAllByBrand(brandId)`**: Retrieves all products for a brand.
+- **`update(technologyId, productId, product)`**: Updates a product.
+- **`delete(technologyId, productId)`**: Soft deletes a product.
+- **`getById(technologyId, productId)`**: Retrieves a product by its ID.
+
+### `ConstantsService`
+
+Manages administrative constants like treatment benefits and contraindications.
+
+- **`getTreatmentBenefits()`**: Retrieves all treatment benefits.
+- **`addTreatmentBenefit(benefit)`**: Adds a new treatment benefit.
+- **`updateTreatmentBenefit(benefit)`**: Updates an existing treatment benefit.
+- **`deleteTreatmentBenefit(benefitId)`**: Deletes a treatment benefit.
+- **`getContraindications()`**: Retrieves all contraindications.
+- **`addContraindication(contraindication)`**: Adds a new contraindication.
+- **`updateContraindication(contraindication)`**: Updates an existing contraindication.
+- **`deleteContraindication(contraindicationId)`**: Deletes a contraindication.

package/src/backoffice/services/brand.service.ts

@@ -7,6 +7,13 @@ import {
   query,
   updateDoc,
   where,
+  limit,
+  orderBy,
+  startAfter,
+  getCountFromServer,
+  Query,
+  DocumentData,
+  QueryConstraint,
 } from "firebase/firestore";
 import { Brand, BRANDS_COLLECTION } from "../types/brand.types";
 import { BaseService } from "../../services/base.service";
@@ -22,10 +29,13 @@ export class BrandService extends BaseService {
   /**
    * Creates a new brand
    */
-  async create(brand: Omit<Brand, "id" | "createdAt" | "updatedAt">) {
+  async create(
+    brand: Omit<Brand, "id" | "createdAt" | "updatedAt" | "name_lowercase">
+  ) {
     const now = new Date();
     const newBrand: Omit<Brand, "id"> = {
       ...brand,
+      name_lowercase: brand.name.toLowerCase(),
       createdAt: now,
       updatedAt: now,
       isActive: true,
@@ -36,10 +46,75 @@ export class BrandService extends BaseService {
   }
 
   /**
-   * Gets all active brands
+   * Gets a paginated list of active brands, optionally filtered by name.
+   * @param rowsPerPage - The number of brands to fetch.
+   * @param searchTerm - An optional string to filter brand names by (starts-with search).
+   * @param lastVisible - An optional document snapshot to use as a cursor for pagination.
+   */
+  async getAll(rowsPerPage: number, searchTerm?: string, lastVisible?: any) {
+    const constraints: QueryConstraint[] = [
+      where("isActive", "==", true),
+      orderBy("name_lowercase"),
+    ];
+
+    if (searchTerm) {
+      const lowercasedSearchTerm = searchTerm.toLowerCase();
+      constraints.push(where("name_lowercase", ">=", lowercasedSearchTerm));
+      constraints.push(
+        where("name_lowercase", "<=", lowercasedSearchTerm + "\uf8ff")
+      );
+    }
+
+    if (lastVisible) {
+      constraints.push(startAfter(lastVisible));
+    }
+
+    constraints.push(limit(rowsPerPage));
+
+    const q = query(this.getBrandsRef(), ...constraints);
+    const snapshot = await getDocs(q);
+
+    const brands = snapshot.docs.map(
+      (doc) =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Brand)
+    );
+    const newLastVisible = snapshot.docs[snapshot.docs.length - 1];
+
+    return { brands, lastVisible: newLastVisible };
+  }
+
+  /**
+   * Gets the total count of active brands, optionally filtered by name.
+   * @param searchTerm - An optional string to filter brand names by (starts-with search).
    */
-  async getAll() {
-    const q = query(this.getBrandsRef(), where("isActive", "==", true));
+  async getBrandsCount(searchTerm?: string) {
+    const constraints: QueryConstraint[] = [where("isActive", "==", true)];
+
+    if (searchTerm) {
+      const lowercasedSearchTerm = searchTerm.toLowerCase();
+      constraints.push(where("name_lowercase", ">=", lowercasedSearchTerm));
+      constraints.push(
+        where("name_lowercase", "<=", lowercasedSearchTerm + "\uf8ff")
+      );
+    }
+
+    const q = query(this.getBrandsRef(), ...constraints);
+    const snapshot = await getCountFromServer(q);
+    return snapshot.data().count;
+  }
+
+  /**
+   * Gets all active brands for filter dropdowns (not paginated).
+   */
+  async getAllForFilter(): Promise<Brand[]> {
+    const q = query(
+      this.getBrandsRef(),
+      where("isActive", "==", true),
+      orderBy("name")
+    );
     const snapshot = await getDocs(q);
     return snapshot.docs.map(
       (doc) =>
@@ -55,13 +130,17 @@ export class BrandService extends BaseService {
    */
   async update(
     brandId: string,
-    brand: Partial<Omit<Brand, "id" | "createdAt">>
+    brand: Partial<Omit<Brand, "id" | "createdAt" | "name_lowercase">>
   ) {
-    const updateData = {
+    const updateData: { [key: string]: any } = {
       ...brand,
       updatedAt: new Date(),
     };
 
+    if (brand.name) {
+      updateData.name_lowercase = brand.name.toLowerCase();
+    }
+
     const docRef = doc(this.getBrandsRef(), brandId);
     await updateDoc(docRef, updateData);
     return this.getById(brandId);

package/src/backoffice/services/category.service.ts

@@ -2,9 +2,14 @@ import {
   addDoc,
   collection,
   doc,
+  DocumentData,
+  getCountFromServer,
   getDoc,
   getDocs,
+  limit,
+  orderBy,
   query,
+  startAfter,
   updateDoc,
   where,
 } from "firebase/firestore";
@@ -52,10 +57,31 @@ export class CategoryService extends BaseService {
   }
 
   /**
-   * Vraća sve aktivne kategorije
-   * @returns Lista aktivnih kategorija
+   * Returns counts of categories for each family.
+   * @param active - Whether to count active or inactive categories.
+   * @returns A record mapping family to category count.
    */
-  async getAll() {
+  async getCategoryCounts(active = true) {
+    const counts: Record<string, number> = {};
+    const families = Object.values(ProcedureFamily);
+
+    for (const family of families) {
+      const q = query(
+        this.categoriesRef,
+        where("family", "==", family),
+        where("isActive", "==", active)
+      );
+      const snapshot = await getCountFromServer(q);
+      counts[family] = snapshot.data().count;
+    }
+    return counts;
+  }
+
+  /**
+   * Vraća sve kategorije za potrebe filtera (bez paginacije)
+   * @returns Lista svih aktivnih kategorija
+   */
+  async getAllForFilter() {
     const q = query(this.categoriesRef, where("isActive", "==", true));
     const snapshot = await getDocs(q);
     return snapshot.docs.map(
@@ -68,24 +94,72 @@ export class CategoryService extends BaseService {
   }
 
   /**
-   * Vraća sve aktivne kategorije za određenu familiju procedura
+   * Vraća sve kategorije sa paginacijom
+   * @param options - Pagination and filter options
+   * @returns Lista kategorija i poslednji vidljiv dokument
+   */
+  async getAll(
+    options: {
+      active?: boolean;
+      limit?: number;
+      lastVisible?: DocumentData;
+    } = {}
+  ) {
+    const { active = true, limit: queryLimit = 10, lastVisible } = options;
+    const constraints = [
+      where("isActive", "==", active),
+      orderBy("name"),
+      queryLimit ? limit(queryLimit) : undefined,
+      lastVisible ? startAfter(lastVisible) : undefined,
+    ].filter((c): c is NonNullable<typeof c> => !!c);
+
+    const q = query(this.categoriesRef, ...constraints);
+    const snapshot = await getDocs(q);
+    const categories = snapshot.docs.map(
+      (doc) =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Category)
+    );
+    const newLastVisible = snapshot.docs[snapshot.docs.length - 1];
+    return { categories, lastVisible: newLastVisible };
+  }
+
+  /**
+   * Vraća sve aktivne kategorije za određenu familiju procedura sa paginacijom
    * @param family - Familija procedura (aesthetics/surgery)
+   * @param options - Pagination options
    * @returns Lista kategorija koje pripadaju traženoj familiji
    */
-  async getAllByFamily(family: ProcedureFamily) {
-    const q = query(
-      this.categoriesRef,
+  async getAllByFamily(
+    family: ProcedureFamily,
+    options: {
+      active?: boolean;
+      limit?: number;
+      lastVisible?: DocumentData;
+    } = {}
+  ) {
+    const { active = true, limit: queryLimit = 10, lastVisible } = options;
+    const constraints = [
       where("family", "==", family),
-      where("isActive", "==", true)
-    );
+      where("isActive", "==", active),
+      orderBy("name"),
+      queryLimit ? limit(queryLimit) : undefined,
+      lastVisible ? startAfter(lastVisible) : undefined,
+    ].filter((c): c is NonNullable<typeof c> => !!c);
+
+    const q = query(this.categoriesRef, ...constraints);
     const snapshot = await getDocs(q);
-    return snapshot.docs.map(
+    const categories = snapshot.docs.map(
       (doc) =>
         ({
           id: doc.id,
           ...doc.data(),
         } as Category)
     );
+    const newLastVisible = snapshot.docs[snapshot.docs.length - 1];
+    return { categories, lastVisible: newLastVisible };
   }
 
   /**
@@ -116,6 +190,14 @@ export class CategoryService extends BaseService {
     await this.update(id, { isActive: false });
   }
 
+  /**
+   * Reactivates a category by setting its isActive flag to true.
+   * @param id - The ID of the category to reactivate.
+   */
+  async reactivate(id: string) {
+    await this.update(id, { isActive: true });
+  }
+
   /**
    * Vraća kategoriju po ID-u
    * @param id - ID tražene kategorije

package/src/backoffice/services/constants.service.ts

@@ -0,0 +1,308 @@
+import {
+  arrayRemove,
+  arrayUnion,
+  collection,
+  doc,
+  getDoc,
+  setDoc,
+  updateDoc,
+} from "firebase/firestore";
+import { BaseService } from "../../services/base.service";
+import {
+  ContraindicationDynamic,
+  ContraindicationsDocument,
+  TreatmentBenefitDynamic,
+  TreatmentBenefitsDocument,
+} from "../types/admin-constants.types";
+
+const ADMIN_CONSTANTS_COLLECTION = "admin-constants";
+const TREATMENT_BENEFITS_DOC = "treatment-benefits";
+const CONTRAINDICATIONS_DOC = "contraindications";
+
+/**
+ * @class ConstantsService
+ * @description Service for managing administrative constants, such as treatment benefits and contraindications.
+ * These constants are stored in a single Firestore collection 'admin-constants',
+ * with each type of constant in its own document ('treatment-benefits', 'contraindications').
+ * The constants themselves are stored in an array within these documents.
+ * @extends {BaseService}
+ */
+export class ConstantsService extends BaseService {
+  /**
+   * @description Gets the reference to the document holding treatment benefits.
+   * @private
+   * @type {DocumentReference}
+   */
+  private get treatmentBenefitsDocRef() {
+    return doc(this.db, ADMIN_CONSTANTS_COLLECTION, TREATMENT_BENEFITS_DOC);
+  }
+
+  /**
+   * @description Gets the reference to the document holding contraindications.
+   * @private
+   * @type {DocumentReference}
+   */
+  private get contraindicationsDocRef() {
+    return doc(this.db, ADMIN_CONSTANTS_COLLECTION, CONTRAINDICATIONS_DOC);
+  }
+
+  // =================================================================
+  // Treatment Benefits
+  // =================================================================
+
+  /**
+   * @description Retrieves all treatment benefits without pagination.
+   * @returns {Promise<TreatmentBenefitDynamic[]>} An array of all treatment benefits.
+   */
+  async getAllBenefitsForFilter(): Promise<TreatmentBenefitDynamic[]> {
+    const docSnap = await getDoc(this.treatmentBenefitsDocRef);
+    if (!docSnap.exists()) {
+      return [];
+    }
+    return (docSnap.data() as TreatmentBenefitsDocument).benefits;
+  }
+
+  /**
+   * @description Retrieves a paginated list of treatment benefits.
+   * @param {{ page: number; limit: number }} options - Pagination options.
+   * @returns {Promise<{ benefits: TreatmentBenefitDynamic[]; total: number }>} A paginated list of benefits and the total count.
+   */
+  async getAllBenefits(options: {
+    page: number;
+    limit: number;
+  }): Promise<{ benefits: TreatmentBenefitDynamic[]; total: number }> {
+    const allBenefits = await this.getAllBenefitsForFilter();
+    const { page, limit } = options;
+    const startIndex = page * limit;
+    const endIndex = startIndex + limit;
+    const paginatedBenefits = allBenefits.slice(startIndex, endIndex);
+    return { benefits: paginatedBenefits, total: allBenefits.length };
+  }
+
+  /**
+   * @description Adds a new treatment benefit.
+   * @param {Omit<TreatmentBenefitDynamic, "id">} benefit - The treatment benefit to add, without an ID.
+   * @returns {Promise<TreatmentBenefitDynamic>} The newly created treatment benefit with its generated ID.
+   */
+  async addTreatmentBenefit(
+    benefit: Omit<TreatmentBenefitDynamic, "id">
+  ): Promise<TreatmentBenefitDynamic> {
+    const newBenefit: TreatmentBenefitDynamic = {
+      id: this.generateId(),
+      ...benefit,
+    };
+
+    const docSnap = await getDoc(this.treatmentBenefitsDocRef);
+    if (!docSnap.exists()) {
+      await setDoc(this.treatmentBenefitsDocRef, { benefits: [newBenefit] });
+    } else {
+      await updateDoc(this.treatmentBenefitsDocRef, {
+        benefits: arrayUnion(newBenefit),
+      });
+    }
+
+    return newBenefit;
+  }
+
+  /**
+   * @description Retrieves a single treatment benefit by its ID.
+   * @param {string} benefitId - The ID of the treatment benefit to retrieve.
+   * @returns {Promise<TreatmentBenefitDynamic | undefined>} The found treatment benefit or undefined.
+   */
+  async getBenefitById(
+    benefitId: string
+  ): Promise<TreatmentBenefitDynamic | undefined> {
+    const benefits = await this.getAllBenefitsForFilter();
+    return benefits.find((b) => b.id === benefitId);
+  }
+
+  /**
+   * @description Searches for treatment benefits by name (case-insensitive).
+   * @param {string} searchTerm - The term to search for in the benefit names.
+   * @returns {Promise<TreatmentBenefitDynamic[]>} An array of matching treatment benefits.
+   */
+  async searchBenefitsByName(
+    searchTerm: string
+  ): Promise<TreatmentBenefitDynamic[]> {
+    const benefits = await this.getAllBenefitsForFilter();
+    const normalizedSearchTerm = searchTerm.toLowerCase();
+    return benefits.filter((b) =>
+      b.name.toLowerCase().includes(normalizedSearchTerm)
+    );
+  }
+
+  /**
+   * @description Updates an existing treatment benefit.
+   * @param {TreatmentBenefitDynamic} benefit - The treatment benefit with updated data. Its ID must match an existing benefit.
+   * @returns {Promise<TreatmentBenefitDynamic>} The updated treatment benefit.
+   * @throws {Error} If the treatment benefit is not found.
+   */
+  async updateTreatmentBenefit(
+    benefit: TreatmentBenefitDynamic
+  ): Promise<TreatmentBenefitDynamic> {
+    const benefits = await this.getAllBenefitsForFilter();
+    const benefitIndex = benefits.findIndex((b) => b.id === benefit.id);
+
+    if (benefitIndex === -1) {
+      throw new Error("Treatment benefit not found.");
+    }
+
+    benefits[benefitIndex] = benefit;
+
+    await updateDoc(this.treatmentBenefitsDocRef, { benefits });
+    return benefit;
+  }
+
+  /**
+   * @description Deletes a treatment benefit by its ID.
+   * @param {string} benefitId - The ID of the treatment benefit to delete.
+   * @returns {Promise<void>}
+   */
+  async deleteTreatmentBenefit(benefitId: string): Promise<void> {
+    const benefits = await this.getAllBenefitsForFilter();
+    const benefitToRemove = benefits.find((b) => b.id === benefitId);
+
+    if (!benefitToRemove) {
+      return;
+    }
+
+    await updateDoc(this.treatmentBenefitsDocRef, {
+      benefits: arrayRemove(benefitToRemove),
+    });
+  }
+
+  // =================================================================
+  // Contraindications
+  // =================================================================
+
+  /**
+   * @description Retrieves all contraindications without pagination.
+   * @returns {Promise<ContraindicationDynamic[]>} An array of all contraindications.
+   */
+  async getAllContraindicationsForFilter(): Promise<ContraindicationDynamic[]> {
+    const docSnap = await getDoc(this.contraindicationsDocRef);
+    if (!docSnap.exists()) {
+      return [];
+    }
+    return (docSnap.data() as ContraindicationsDocument).contraindications;
+  }
+
+  /**
+   * @description Retrieves a paginated list of contraindications.
+   * @param {{ page: number; limit: number }} options - Pagination options.
+   * @returns {Promise<{ contraindications: ContraindicationDynamic[]; total: number }>} A paginated list and the total count.
+   */
+  async getAllContraindications(options: {
+    page: number;
+    limit: number;
+  }): Promise<{ contraindications: ContraindicationDynamic[]; total: number }> {
+    const allContraindications = await this.getAllContraindicationsForFilter();
+    const { page, limit } = options;
+    const startIndex = page * limit;
+    const endIndex = startIndex + limit;
+    const paginatedContraindications = allContraindications.slice(
+      startIndex,
+      endIndex
+    );
+    return {
+      contraindications: paginatedContraindications,
+      total: allContraindications.length,
+    };
+  }
+
+  /**
+   * @description Adds a new contraindication.
+   * @param {Omit<ContraindicationDynamic, "id">} contraindication - The contraindication to add, without an ID.
+   * @returns {Promise<ContraindicationDynamic>} The newly created contraindication with its generated ID.
+   */
+  async addContraindication(
+    contraindication: Omit<ContraindicationDynamic, "id">
+  ): Promise<ContraindicationDynamic> {
+    const newContraindication: ContraindicationDynamic = {
+      id: this.generateId(),
+      ...contraindication,
+    };
+
+    const docSnap = await getDoc(this.contraindicationsDocRef);
+    if (!docSnap.exists()) {
+      await setDoc(this.contraindicationsDocRef, {
+        contraindications: [newContraindication],
+      });
+    } else {
+      await updateDoc(this.contraindicationsDocRef, {
+        contraindications: arrayUnion(newContraindication),
+      });
+    }
+
+    return newContraindication;
+  }
+
+  /**
+   * @description Retrieves a single contraindication by its ID.
+   * @param {string} contraindicationId - The ID of the contraindication to retrieve.
+   * @returns {Promise<ContraindicationDynamic | undefined>} The found contraindication or undefined.
+   */
+  async getContraindicationById(
+    contraindicationId: string
+  ): Promise<ContraindicationDynamic | undefined> {
+    const contraindications = await this.getAllContraindicationsForFilter();
+    return contraindications.find((c) => c.id === contraindicationId);
+  }
+
+  /**
+   * @description Searches for contraindications by name (case-insensitive).
+   * @param {string} searchTerm - The term to search for in the contraindication names.
+   * @returns {Promise<ContraindicationDynamic[]>} An array of matching contraindications.
+   */
+  async searchContraindicationsByName(
+    searchTerm: string
+  ): Promise<ContraindicationDynamic[]> {
+    const contraindications = await this.getAllContraindicationsForFilter();
+    const normalizedSearchTerm = searchTerm.toLowerCase();
+    return contraindications.filter((c) =>
+      c.name.toLowerCase().includes(normalizedSearchTerm)
+    );
+  }
+
+  /**
+   * @description Updates an existing contraindication.
+   * @param {ContraindicationDynamic} contraindication - The contraindication with updated data. Its ID must match an existing one.
+   * @returns {Promise<ContraindicationDynamic>} The updated contraindication.
+   * @throws {Error} If the contraindication is not found.
+   */
+  async updateContraindication(
+    contraindication: ContraindicationDynamic
+  ): Promise<ContraindicationDynamic> {
+    const contraindications = await this.getAllContraindicationsForFilter();
+    const index = contraindications.findIndex(
+      (c) => c.id === contraindication.id
+    );
+
+    if (index === -1) {
+      throw new Error("Contraindication not found.");
+    }
+
+    contraindications[index] = contraindication;
+
+    await updateDoc(this.contraindicationsDocRef, { contraindications });
+    return contraindication;
+  }
+
+  /**
+   * @description Deletes a contraindication by its ID.
+   * @param {string} contraindicationId - The ID of the contraindication to delete.
+   * @returns {Promise<void>}
+   */
+  async deleteContraindication(contraindicationId: string): Promise<void> {
+    const contraindications = await this.getAllContraindicationsForFilter();
+    const toRemove = contraindications.find((c) => c.id === contraindicationId);
+
+    if (!toRemove) {
+      return;
+    }
+
+    await updateDoc(this.contraindicationsDocRef, {
+      contraindications: arrayRemove(toRemove),
+    });
+  }
+}