@blackcode_sa/metaestetics-api 1.13.4 → 1.13.5

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

@@ -1,384 +1,384 @@
-import {
-  addDoc,
-  collection,
-  doc,
-  DocumentData,
-  getCountFromServer,
-  getDoc,
-  getDocs,
-  limit,
-  orderBy,
-  query,
-  startAfter,
-  updateDoc,
-  where,
-} from 'firebase/firestore';
-import { Category, CATEGORIES_COLLECTION, ICategoryService } from '../types/category.types';
-import { BaseService } from '../../services/base.service';
-import { ProcedureFamily } from '../types/static/procedure-family.types';
-
-/**
- * ID of the consultation category that should be hidden from admin backoffice.
- * This category is used internally for free consultation procedures.
- */
-const EXCLUDED_CATEGORY_ID = 'consultation';
-
-/**
- * Servis za upravljanje kategorijama procedura.
- * Kategorije su prvi nivo organizacije nakon procedure family (aesthetics/surgery).
- *
- * @example
- * const categoryService = new CategoryService();
- *
- * // Kreiranje nove kategorije
- * const category = await categoryService.create({
- *   name: "Injectables",
- *   family: ProcedureFamily.AESTHETICS
- * });
- */
-export class CategoryService extends BaseService implements ICategoryService {
-  /**
-   * Filters out excluded categories from a list.
-   * @param categories - List of categories to filter
-   * @returns Filtered list without excluded categories
-   */
-  private filterExcludedCategories(categories: Category[]): Category[] {
-    return categories.filter(cat => cat.id !== EXCLUDED_CATEGORY_ID);
-  }
-  /**
-   * Referenca na Firestore kolekciju kategorija
-   */
-  private get categoriesRef() {
-    return collection(this.db, CATEGORIES_COLLECTION);
-  }
-
-  /**
-   * Kreira novu kategoriju u sistemu
-   * @param category - Podaci za novu kategoriju
-   * @returns Kreirana kategorija sa generisanim ID-em
-   */
-  async create(category: Omit<Category, 'id' | 'createdAt' | 'updatedAt'>) {
-    const now = new Date();
-    const newCategory: Omit<Category, 'id'> = {
-      ...category,
-      createdAt: now,
-      updatedAt: now,
-      isActive: true,
-    };
-
-    const docRef = await addDoc(this.categoriesRef, newCategory);
-    return { id: docRef.id, ...newCategory };
-  }
-
-  /**
-   * 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 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 getDocs(q);
-      // Filter out excluded category and count
-      const filteredDocs = snapshot.docs.filter(doc => doc.id !== EXCLUDED_CATEGORY_ID);
-      counts[family] = filteredDocs.length;
-    }
-    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);
-    const categories = snapshot.docs.map(
-      doc =>
-        ({
-          id: doc.id,
-          ...doc.data(),
-        } as Category),
-    );
-    return this.filterExcludedCategories(categories);
-  }
-
-  /**
-   * Vraća sve kategorije za određenu familiju za potrebe filtera (bez paginacije)
-   * @param family - Familija procedura (aesthetics/surgery)
-   * @returns Lista aktivnih kategorija koje pripadaju traženoj familiji
-   */
-  async getAllForFilterByFamily(family: ProcedureFamily) {
-    const q = query(
-      this.categoriesRef,
-      where('family', '==', family),
-      where('isActive', '==', true),
-      orderBy('name'),
-    );
-    const snapshot = await getDocs(q);
-    const categories = snapshot.docs.map(
-      doc =>
-        ({
-          id: doc.id,
-          ...doc.data(),
-        } as Category),
-    );
-    return this.filterExcludedCategories(categories);
-  }
-
-  /**
-   * 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 filteredCategories = this.filterExcludedCategories(categories);
-    const newLastVisible = snapshot.docs[snapshot.docs.length - 1];
-    return { categories: filteredCategories, 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,
-    options: {
-      active?: boolean;
-      limit?: number;
-      lastVisible?: DocumentData;
-    } = {},
-  ) {
-    const { active = true, limit: queryLimit = 10, lastVisible } = options;
-    const constraints = [
-      where('family', '==', family),
-      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 filteredCategories = this.filterExcludedCategories(categories);
-    const newLastVisible = snapshot.docs[snapshot.docs.length - 1];
-    return { categories: filteredCategories, lastVisible: newLastVisible };
-  }
-
-  /**
-   * Ažurira postojeću kategoriju
-   * @param id - ID kategorije koja se ažurira
-   * @param category - Novi podaci za kategoriju
-   * @returns Ažurirana kategorija
-   */
-  async update(id: string, category: Partial<Omit<Category, 'id' | 'createdAt'>>) {
-    const updateData = {
-      ...category,
-      updatedAt: new Date(),
-    };
-
-    const docRef = doc(this.categoriesRef, id);
-    await updateDoc(docRef, updateData);
-    return this.getById(id);
-  }
-
-  /**
-   * Soft delete kategorije (postavlja isActive na false)
-   * @param id - ID kategorije koja se briše
-   */
-  async delete(id: string) {
-    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
-   * @returns Kategorija ili null ako ne postoji
-   */
-  async getById(id: string) {
-    // Prevent access to excluded category
-    if (id === EXCLUDED_CATEGORY_ID) return null;
-    
-    const docRef = doc(this.categoriesRef, id);
-    const docSnap = await getDoc(docRef);
-    if (!docSnap.exists()) return null;
-    return {
-      id: docSnap.id,
-      ...docSnap.data(),
-    } as Category;
-  }
-
-  /**
-   * Internal method to get category by ID without filtering.
-   * Used internally for consultation procedures.
-   * @param id - ID of the category to get
-   * @returns Category or null if not found
-   */
-  async getByIdInternal(id: string): Promise<Category | null> {
-    const docRef = doc(this.categoriesRef, id);
-    const docSnap = await getDoc(docRef);
-    if (!docSnap.exists()) return null;
-    return {
-      id: docSnap.id,
-      ...docSnap.data(),
-    } as Category;
-  }
-
-  /**
-   * Finds a category by exact name match within a specific family.
-   * Used for CSV import matching.
-   * @param name - Exact name of the category to find
-   * @param family - Procedure family to search within
-   * @returns Category if found, null otherwise
-   */
-  async findByNameAndFamily(name: string, family: ProcedureFamily): Promise<Category | null> {
-    const q = query(
-      this.categoriesRef,
-      where('name', '==', name),
-      where('family', '==', family),
-      where('isActive', '==', true),
-    );
-    const snapshot = await getDocs(q);
-    if (snapshot.empty) return null;
-    const doc = snapshot.docs[0];
-    // Exclude consultation category
-    if (doc.id === EXCLUDED_CATEGORY_ID) return null;
-    return {
-      id: doc.id,
-      ...doc.data(),
-    } as Category;
-  }
-
-  /**
-   * Exports categories to CSV string, suitable for Excel/Sheets.
-   * Includes headers and optional UTF-8 BOM.
-   * By default exports only active categories (set includeInactive to true to export all).
-   */
-  async exportToCsv(options?: {
-    includeInactive?: boolean;
-    includeBom?: boolean;
-  }): Promise<string> {
-    const includeInactive = options?.includeInactive ?? false;
-    const includeBom = options?.includeBom ?? true;
-
-    const headers = [
-      "id",
-      "name",
-      "description",
-      "family",
-      "isActive",
-    ];
-
-    const rows: string[] = [];
-    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
-
-    const PAGE_SIZE = 1000;
-    let cursor: any | undefined;
-
-    // Build base constraints
-    const constraints: any[] = [];
-    if (!includeInactive) {
-      constraints.push(where("isActive", "==", true));
-    }
-    constraints.push(orderBy("name"));
-
-    // Page through all results
-    // eslint-disable-next-line no-constant-condition
-    while (true) {
-      const queryConstraints: any[] = [...constraints, limit(PAGE_SIZE)];
-      if (cursor) queryConstraints.push(startAfter(cursor));
-
-      const q = query(this.categoriesRef, ...queryConstraints);
-      const snapshot = await getDocs(q);
-      if (snapshot.empty) break;
-
-      for (const d of snapshot.docs) {
-        // Exclude consultation category from CSV export
-        if (d.id === EXCLUDED_CATEGORY_ID) continue;
-        const category = ({ id: d.id, ...d.data() } as unknown) as Category;
-        rows.push(this.categoryToCsvRow(category));
-      }
-
-      cursor = snapshot.docs[snapshot.docs.length - 1];
-      if (snapshot.size < PAGE_SIZE) break;
-    }
-
-    const csvBody = rows.join("\r\n");
-    return includeBom ? "\uFEFF" + csvBody : csvBody;
-  }
-
-  private categoryToCsvRow(category: Category): string {
-    const values = [
-      category.id ?? "",
-      category.name ?? "",
-      category.description ?? "",
-      category.family ?? "",
-      String(category.isActive ?? ""),
-    ];
-    return values.map((v) => this.formatCsvValue(v)).join(",");
-  }
-
-  private formatDateIso(value: any): string {
-    // Firestore timestamps may come back as Date or Timestamp; handle both
-    if (value instanceof Date) return value.toISOString();
-    if (value && typeof value.toDate === "function") {
-      const d = value.toDate();
-      return d instanceof Date ? d.toISOString() : String(value);
-    }
-    return String(value ?? "");
-  }
-
-  private formatCsvValue(value: any): string {
-    const str = value === null || value === undefined ? "" : String(value);
-    // Escape double quotes by doubling them and wrap in quotes
-    const escaped = str.replace(/"/g, '""');
-    return `"${escaped}"`;
-  }
-}
+import {
+  addDoc,
+  collection,
+  doc,
+  DocumentData,
+  getCountFromServer,
+  getDoc,
+  getDocs,
+  limit,
+  orderBy,
+  query,
+  startAfter,
+  updateDoc,
+  where,
+} from 'firebase/firestore';
+import { Category, CATEGORIES_COLLECTION, ICategoryService } from '../types/category.types';
+import { BaseService } from '../../services/base.service';
+import { ProcedureFamily } from '../types/static/procedure-family.types';
+
+/**
+ * ID of the consultation category that should be hidden from admin backoffice.
+ * This category is used internally for free consultation procedures.
+ */
+const EXCLUDED_CATEGORY_ID = 'consultation';
+
+/**
+ * Servis za upravljanje kategorijama procedura.
+ * Kategorije su prvi nivo organizacije nakon procedure family (aesthetics/surgery).
+ *
+ * @example
+ * const categoryService = new CategoryService();
+ *
+ * // Kreiranje nove kategorije
+ * const category = await categoryService.create({
+ *   name: "Injectables",
+ *   family: ProcedureFamily.AESTHETICS
+ * });
+ */
+export class CategoryService extends BaseService implements ICategoryService {
+  /**
+   * Filters out excluded categories from a list.
+   * @param categories - List of categories to filter
+   * @returns Filtered list without excluded categories
+   */
+  private filterExcludedCategories(categories: Category[]): Category[] {
+    return categories.filter(cat => cat.id !== EXCLUDED_CATEGORY_ID);
+  }
+  /**
+   * Referenca na Firestore kolekciju kategorija
+   */
+  private get categoriesRef() {
+    return collection(this.db, CATEGORIES_COLLECTION);
+  }
+
+  /**
+   * Kreira novu kategoriju u sistemu
+   * @param category - Podaci za novu kategoriju
+   * @returns Kreirana kategorija sa generisanim ID-em
+   */
+  async create(category: Omit<Category, 'id' | 'createdAt' | 'updatedAt'>) {
+    const now = new Date();
+    const newCategory: Omit<Category, 'id'> = {
+      ...category,
+      createdAt: now,
+      updatedAt: now,
+      isActive: true,
+    };
+
+    const docRef = await addDoc(this.categoriesRef, newCategory);
+    return { id: docRef.id, ...newCategory };
+  }
+
+  /**
+   * 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 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 getDocs(q);
+      // Filter out excluded category and count
+      const filteredDocs = snapshot.docs.filter(doc => doc.id !== EXCLUDED_CATEGORY_ID);
+      counts[family] = filteredDocs.length;
+    }
+    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);
+    const categories = snapshot.docs.map(
+      doc =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Category),
+    );
+    return this.filterExcludedCategories(categories);
+  }
+
+  /**
+   * Vraća sve kategorije za određenu familiju za potrebe filtera (bez paginacije)
+   * @param family - Familija procedura (aesthetics/surgery)
+   * @returns Lista aktivnih kategorija koje pripadaju traženoj familiji
+   */
+  async getAllForFilterByFamily(family: ProcedureFamily) {
+    const q = query(
+      this.categoriesRef,
+      where('family', '==', family),
+      where('isActive', '==', true),
+      orderBy('name'),
+    );
+    const snapshot = await getDocs(q);
+    const categories = snapshot.docs.map(
+      doc =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Category),
+    );
+    return this.filterExcludedCategories(categories);
+  }
+
+  /**
+   * 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 filteredCategories = this.filterExcludedCategories(categories);
+    const newLastVisible = snapshot.docs[snapshot.docs.length - 1];
+    return { categories: filteredCategories, 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,
+    options: {
+      active?: boolean;
+      limit?: number;
+      lastVisible?: DocumentData;
+    } = {},
+  ) {
+    const { active = true, limit: queryLimit = 10, lastVisible } = options;
+    const constraints = [
+      where('family', '==', family),
+      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 filteredCategories = this.filterExcludedCategories(categories);
+    const newLastVisible = snapshot.docs[snapshot.docs.length - 1];
+    return { categories: filteredCategories, lastVisible: newLastVisible };
+  }
+
+  /**
+   * Ažurira postojeću kategoriju
+   * @param id - ID kategorije koja se ažurira
+   * @param category - Novi podaci za kategoriju
+   * @returns Ažurirana kategorija
+   */
+  async update(id: string, category: Partial<Omit<Category, 'id' | 'createdAt'>>) {
+    const updateData = {
+      ...category,
+      updatedAt: new Date(),
+    };
+
+    const docRef = doc(this.categoriesRef, id);
+    await updateDoc(docRef, updateData);
+    return this.getById(id);
+  }
+
+  /**
+   * Soft delete kategorije (postavlja isActive na false)
+   * @param id - ID kategorije koja se briše
+   */
+  async delete(id: string) {
+    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
+   * @returns Kategorija ili null ako ne postoji
+   */
+  async getById(id: string) {
+    // Prevent access to excluded category
+    if (id === EXCLUDED_CATEGORY_ID) return null;
+    
+    const docRef = doc(this.categoriesRef, id);
+    const docSnap = await getDoc(docRef);
+    if (!docSnap.exists()) return null;
+    return {
+      id: docSnap.id,
+      ...docSnap.data(),
+    } as Category;
+  }
+
+  /**
+   * Internal method to get category by ID without filtering.
+   * Used internally for consultation procedures.
+   * @param id - ID of the category to get
+   * @returns Category or null if not found
+   */
+  async getByIdInternal(id: string): Promise<Category | null> {
+    const docRef = doc(this.categoriesRef, id);
+    const docSnap = await getDoc(docRef);
+    if (!docSnap.exists()) return null;
+    return {
+      id: docSnap.id,
+      ...docSnap.data(),
+    } as Category;
+  }
+
+  /**
+   * Finds a category by exact name match within a specific family.
+   * Used for CSV import matching.
+   * @param name - Exact name of the category to find
+   * @param family - Procedure family to search within
+   * @returns Category if found, null otherwise
+   */
+  async findByNameAndFamily(name: string, family: ProcedureFamily): Promise<Category | null> {
+    const q = query(
+      this.categoriesRef,
+      where('name', '==', name),
+      where('family', '==', family),
+      where('isActive', '==', true),
+    );
+    const snapshot = await getDocs(q);
+    if (snapshot.empty) return null;
+    const doc = snapshot.docs[0];
+    // Exclude consultation category
+    if (doc.id === EXCLUDED_CATEGORY_ID) return null;
+    return {
+      id: doc.id,
+      ...doc.data(),
+    } as Category;
+  }
+
+  /**
+   * Exports categories to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active categories (set includeInactive to true to export all).
+   */
+  async exportToCsv(options?: {
+    includeInactive?: boolean;
+    includeBom?: boolean;
+  }): Promise<string> {
+    const includeInactive = options?.includeInactive ?? false;
+    const includeBom = options?.includeBom ?? true;
+
+    const headers = [
+      "id",
+      "name",
+      "description",
+      "family",
+      "isActive",
+    ];
+
+    const rows: string[] = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+
+    const PAGE_SIZE = 1000;
+    let cursor: any | undefined;
+
+    // Build base constraints
+    const constraints: any[] = [];
+    if (!includeInactive) {
+      constraints.push(where("isActive", "==", true));
+    }
+    constraints.push(orderBy("name"));
+
+    // Page through all results
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+      const queryConstraints: any[] = [...constraints, limit(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter(cursor));
+
+      const q = query(this.categoriesRef, ...queryConstraints);
+      const snapshot = await getDocs(q);
+      if (snapshot.empty) break;
+
+      for (const d of snapshot.docs) {
+        // Exclude consultation category from CSV export
+        if (d.id === EXCLUDED_CATEGORY_ID) continue;
+        const category = ({ id: d.id, ...d.data() } as unknown) as Category;
+        rows.push(this.categoryToCsvRow(category));
+      }
+
+      cursor = snapshot.docs[snapshot.docs.length - 1];
+      if (snapshot.size < PAGE_SIZE) break;
+    }
+
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+
+  private categoryToCsvRow(category: Category): string {
+    const values = [
+      category.id ?? "",
+      category.name ?? "",
+      category.description ?? "",
+      category.family ?? "",
+      String(category.isActive ?? ""),
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+
+  private formatDateIso(value: any): string {
+    // Firestore timestamps may come back as Date or Timestamp; handle both
+    if (value instanceof Date) return value.toISOString();
+    if (value && typeof value.toDate === "function") {
+      const d = value.toDate();
+      return d instanceof Date ? d.toISOString() : String(value);
+    }
+    return String(value ?? "");
+  }
+
+  private formatCsvValue(value: any): string {
+    const str = value === null || value === undefined ? "" : String(value);
+    // Escape double quotes by doubling them and wrap in quotes
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
+}