@blackcode_sa/metaestetics-api 1.12.50 → 1.12.51

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

@@ -13,6 +13,8 @@ import {
   startAfter,
   getCountFromServer,
   QueryConstraint,
+  arrayUnion,
+  arrayRemove,
 } from 'firebase/firestore';
 import { Product, PRODUCTS_COLLECTION, IProductService } from '../types/product.types';
 import { BaseService } from '../../services/base.service';
@@ -20,7 +22,15 @@ import { TECHNOLOGIES_COLLECTION } from '../types/technology.types';
 
 export class ProductService extends BaseService implements IProductService {
   /**
-   * Gets reference to products collection under a technology
+   * Gets reference to top-level products collection (source of truth)
+   * @returns Firestore collection reference
+   */
+  private getTopLevelProductsRef() {
+    return collection(this.db, PRODUCTS_COLLECTION);
+  }
+
+  /**
+   * Gets reference to products collection under a technology (backward compatibility)
    * @param technologyId - ID of the technology
    * @returns Firestore collection reference
    */
@@ -37,11 +47,11 @@ export class ProductService extends BaseService implements IProductService {
     product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'brandId' | 'technologyId'>,
   ): Promise<Product> {
     const now = new Date();
-    // categoryId and subcategoryId are now expected to be part of the product object
+    // Create product with legacy structure for subcollection compatibility
     const newProduct: Omit<Product, 'id'> = {
       ...product,
       brandId,
-      technologyId,
+      technologyId, // Required for old subcollection structure
       createdAt: now,
       updatedAt: now,
       isActive: true,
@@ -125,38 +135,35 @@ export class ProductService extends BaseService implements IProductService {
 
   /**
    * Gets counts of active products grouped by category, subcategory, and technology.
-   * This uses a single collectionGroup query for efficiency.
+   * Queries technology subcollections which have the legacy fields synced by Cloud Functions.
    */
   async getProductCounts(): Promise<{
     byCategory: Record<string, number>;
     bySubcategory: Record<string, number>;
     byTechnology: Record<string, number>;
   }> {
-    const q = query(collectionGroup(this.db, PRODUCTS_COLLECTION), where('isActive', '==', true));
-    const snapshot = await getDocs(q);
-
     const counts = {
       byCategory: {} as Record<string, number>,
       bySubcategory: {} as Record<string, number>,
       byTechnology: {} as Record<string, number>,
     };
 
-    if (snapshot.empty) {
-      return counts;
-    }
+    // Query technology subcollections (which have synced legacy fields)
+    const q = query(collectionGroup(this.db, PRODUCTS_COLLECTION), where('isActive', '==', true));
+    const snapshot = await getDocs(q);
 
     snapshot.docs.forEach(doc => {
       const product = doc.data() as Product;
-      const { categoryId, subcategoryId, technologyId } = product;
-
-      if (categoryId) {
-        counts.byCategory[categoryId] = (counts.byCategory[categoryId] || 0) + 1;
+      
+      // Use legacy fields from subcollections
+      if (product.categoryId) {
+        counts.byCategory[product.categoryId] = (counts.byCategory[product.categoryId] || 0) + 1;
       }
-      if (subcategoryId) {
-        counts.bySubcategory[subcategoryId] = (counts.bySubcategory[subcategoryId] || 0) + 1;
+      if (product.subcategoryId) {
+        counts.bySubcategory[product.subcategoryId] = (counts.bySubcategory[product.subcategoryId] || 0) + 1;
       }
-      if (technologyId) {
-        counts.byTechnology[technologyId] = (counts.byTechnology[technologyId] || 0) + 1;
+      if (product.technologyId) {
+        counts.byTechnology[product.technologyId] = (counts.byTechnology[product.technologyId] || 0) + 1;
       }
     });
 
@@ -252,4 +259,295 @@ export class ProductService extends BaseService implements IProductService {
       ...docSnap.data(),
     } as Product;
   }
+
+  // ==========================================
+  // NEW METHODS: Top-level collection (preferred)
+  // ==========================================
+
+  /**
+   * Creates a new product in the top-level collection
+   */
+  async createTopLevel(
+    brandId: string,
+    product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'brandId' | 'assignedTechnologyIds'>,
+    technologyIds: string[] = [],
+  ): Promise<Product> {
+    const now = new Date();
+    const newProduct: Omit<Product, 'id'> = {
+      ...product,
+      brandId,
+      assignedTechnologyIds: technologyIds,
+      createdAt: now,
+      updatedAt: now,
+      isActive: true,
+    };
+
+    const productRef = await addDoc(this.getTopLevelProductsRef(), newProduct);
+    return { id: productRef.id, ...newProduct };
+  }
+
+  /**
+   * Gets all products from the top-level collection
+   */
+  async getAllTopLevel(options: {
+    rowsPerPage: number;
+    lastVisible?: any;
+    brandId?: string;
+  }): Promise<{ products: Product[]; lastVisible: any }> {
+    const { rowsPerPage, lastVisible, brandId } = options;
+
+    const constraints: QueryConstraint[] = [where('isActive', '==', true), orderBy('name')];
+
+    if (brandId) {
+      constraints.push(where('brandId', '==', brandId));
+    }
+
+    if (lastVisible) {
+      constraints.push(startAfter(lastVisible));
+    }
+    constraints.push(limit(rowsPerPage));
+
+    const q = query(this.getTopLevelProductsRef(), ...constraints);
+    const snapshot = await getDocs(q);
+
+    const products = snapshot.docs.map(
+      doc =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Product),
+    );
+    const newLastVisible = snapshot.docs[snapshot.docs.length - 1];
+
+    return { products, lastVisible: newLastVisible };
+  }
+
+  /**
+   * Gets a product by ID from the top-level collection
+   */
+  async getByIdTopLevel(productId: string): Promise<Product | null> {
+    const docRef = doc(this.getTopLevelProductsRef(), productId);
+    const docSnap = await getDoc(docRef);
+    if (!docSnap.exists()) return null;
+    return {
+      id: docSnap.id,
+      ...docSnap.data(),
+    } as Product;
+  }
+
+  /**
+   * Updates a product in the top-level collection
+   */
+  async updateTopLevel(
+    productId: string,
+    product: Partial<Omit<Product, 'id' | 'createdAt' | 'brandId'>>,
+  ): Promise<Product | null> {
+    const updateData = {
+      ...product,
+      updatedAt: new Date(),
+    };
+
+    const docRef = doc(this.getTopLevelProductsRef(), productId);
+    await updateDoc(docRef, updateData);
+
+    return this.getByIdTopLevel(productId);
+  }
+
+  /**
+   * Deletes a product from the top-level collection (soft delete)
+   */
+  async deleteTopLevel(productId: string): Promise<void> {
+    await this.updateTopLevel(productId, {
+      isActive: false,
+    });
+  }
+
+  /**
+   * Assigns a product to a technology
+   */
+  async assignToTechnology(productId: string, technologyId: string): Promise<void> {
+    const docRef = doc(this.getTopLevelProductsRef(), productId);
+    await updateDoc(docRef, {
+      assignedTechnologyIds: arrayUnion(technologyId),
+      updatedAt: new Date(),
+    });
+    // Cloud Function will handle syncing to subcollection
+  }
+
+  /**
+   * Unassigns a product from a technology
+   */
+  async unassignFromTechnology(productId: string, technologyId: string): Promise<void> {
+    const docRef = doc(this.getTopLevelProductsRef(), productId);
+    await updateDoc(docRef, {
+      assignedTechnologyIds: arrayRemove(technologyId),
+      updatedAt: new Date(),
+    });
+    // Cloud Function will handle removing from subcollection
+  }
+
+  /**
+   * Gets products assigned to a specific technology
+   */
+  async getAssignedProducts(technologyId: string): Promise<Product[]> {
+    const q = query(
+      this.getTopLevelProductsRef(),
+      where('assignedTechnologyIds', 'array-contains', technologyId),
+      where('isActive', '==', true),
+      orderBy('name'),
+    );
+    const snapshot = await getDocs(q);
+    return snapshot.docs.map(
+      doc =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Product),
+    );
+  }
+
+  /**
+   * Gets products NOT assigned to a specific technology
+   */
+  async getUnassignedProducts(technologyId: string): Promise<Product[]> {
+    const q = query(
+      this.getTopLevelProductsRef(),
+      where('isActive', '==', true),
+      orderBy('name'),
+    );
+    const snapshot = await getDocs(q);
+    
+    const allProducts = snapshot.docs.map(
+      doc =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Product),
+    );
+    
+    // Filter out products already assigned to this technology
+    return allProducts.filter(product => 
+      !product.assignedTechnologyIds?.includes(technologyId)
+    );
+  }
+
+  /**
+   * Gets all products for a brand (from top-level collection)
+   */
+  async getByBrand(brandId: string): Promise<Product[]> {
+    const q = query(
+      this.getTopLevelProductsRef(),
+      where('brandId', '==', brandId),
+      where('isActive', '==', true),
+      orderBy('name'),
+    );
+    const snapshot = await getDocs(q);
+    return snapshot.docs.map(
+      doc =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Product),
+    );
+  }
+
+  /**
+   * Exports products to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active products (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",
+      "brandId",
+      "brandName",
+      "assignedTechnologyIds",
+      "description",
+      "technicalDetails",
+      "dosage",
+      "composition",
+      "indications",
+      "contraindications",
+      "warnings",
+      "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: QueryConstraint[] = [];
+    if (!includeInactive) {
+      constraints.push(where("isActive", "==", true));
+    }
+    constraints.push(orderBy("name"));
+
+    // Page through all results from top-level collection
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+      const queryConstraints: QueryConstraint[] = [...constraints, limit(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter(cursor));
+
+      const q = query(this.getTopLevelProductsRef(), ...queryConstraints);
+      const snapshot = await getDocs(q);
+      if (snapshot.empty) break;
+
+      for (const d of snapshot.docs) {
+        const product = ({ id: d.id, ...d.data() } as unknown) as Product;
+        rows.push(this.productToCsvRow(product));
+      }
+
+      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 productToCsvRow(product: Product): string {
+    const values = [
+      product.id ?? "",
+      product.name ?? "",
+      product.brandId ?? "",
+      product.brandName ?? "",
+      product.assignedTechnologyIds?.join(";") ?? "",
+      product.description ?? "",
+      product.technicalDetails ?? "",
+      product.dosage ?? "",
+      product.composition ?? "",
+      product.indications?.join(";") ?? "",
+      product.contraindications?.map(c => c.name).join(";") ?? "",
+      product.warnings?.join(";") ?? "",
+      String(product.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}"`;
+  }
 }

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

@@ -7,6 +7,7 @@ import {
   query,
   updateDoc,
   where,
+  orderBy,
 } from "firebase/firestore";
 import {
   Requirement,
@@ -156,4 +157,79 @@ export class RequirementService extends BaseService {
       ...docSnap.data(),
     } as Requirement;
   }
+
+  /**
+   * Exports requirements to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active requirements (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",
+      "type",
+      "name",
+      "description",
+      "timeframe_duration",
+      "timeframe_unit",
+      "timeframe_notifyAt",
+      "importance",
+      "isActive",
+    ];
+
+    const rows: string[] = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+
+    // Get all requirements (they're not paginated in the original service)
+    const q = includeInactive
+      ? query(this.requirementsRef, orderBy("name"))
+      : query(this.requirementsRef, where("isActive", "==", true), orderBy("name"));
+    
+    const snapshot = await getDocs(q);
+
+    for (const d of snapshot.docs) {
+      const requirement = ({ id: d.id, ...d.data() } as unknown) as Requirement;
+      rows.push(this.requirementToCsvRow(requirement));
+    }
+
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+
+  private requirementToCsvRow(requirement: Requirement): string {
+    const values = [
+      requirement.id ?? "",
+      requirement.type ?? "",
+      requirement.name ?? "",
+      requirement.description ?? "",
+      requirement.timeframe?.duration?.toString() ?? "",
+      requirement.timeframe?.unit ?? "",
+      requirement.timeframe?.notifyAt?.join(";") ?? "",
+      requirement.importance ?? "",
+      String(requirement.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}"`;
+  }
 }

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

@@ -305,4 +305,91 @@ export class SubcategoryService extends BaseService {
       ...docSnap.data(),
     } as Subcategory;
   }
+
+  /**
+   * Exports subcategories to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active subcategories (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",
+      "categoryId",
+      "description",
+      "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 using collectionGroup
+    // 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(
+        collectionGroup(this.db, SUBCATEGORIES_COLLECTION),
+        ...queryConstraints
+      );
+      const snapshot = await getDocs(q);
+      if (snapshot.empty) break;
+
+      for (const d of snapshot.docs) {
+        const subcategory = ({ id: d.id, ...d.data() } as unknown) as Subcategory;
+        rows.push(this.subcategoryToCsvRow(subcategory));
+      }
+
+      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 subcategoryToCsvRow(subcategory: Subcategory): string {
+    const values = [
+      subcategory.id ?? "",
+      subcategory.name ?? "",
+      subcategory.categoryId ?? "",
+      subcategory.description ?? "",
+      String(subcategory.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}"`;
+  }
 }