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

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

@@ -1,557 +1,557 @@
-import {
-  addDoc,
-  collection,
-  collectionGroup,
-  doc,
-  getDoc,
-  getDocs,
-  query,
-  updateDoc,
-  where,
-  limit,
-  orderBy,
-  startAfter,
-  getCountFromServer,
-  QueryConstraint,
-  arrayUnion,
-  arrayRemove,
-} from 'firebase/firestore';
-import { Product, PRODUCTS_COLLECTION, IProductService } from '../types/product.types';
-import { BaseService } from '../../services/base.service';
-import { TECHNOLOGIES_COLLECTION } from '../types/technology.types';
-
-export class ProductService extends BaseService implements IProductService {
-  /**
-   * 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
-   */
-  private getProductsRef(technologyId: string) {
-    return collection(this.db, TECHNOLOGIES_COLLECTION, technologyId, PRODUCTS_COLLECTION);
-  }
-
-  /**
-   * Creates a new product under technology
-   */
-  async create(
-    technologyId: string,
-    brandId: string,
-    product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'brandId' | 'technologyId'>,
-  ): Promise<Product> {
-    const now = new Date();
-    // Create product with legacy structure for subcollection compatibility
-    const newProduct: Omit<Product, 'id'> = {
-      ...product,
-      brandId,
-      technologyId, // Required for old subcollection structure
-      createdAt: now,
-      updatedAt: now,
-      isActive: true,
-    };
-
-    const productRef = await addDoc(this.getProductsRef(technologyId), newProduct);
-
-    return { id: productRef.id, ...newProduct };
-  }
-
-  /**
-   * Gets a paginated list of all products, with optional filters.
-   * This uses a collectionGroup query to search across all technologies.
-   */
-  async getAll(options: {
-    rowsPerPage: number;
-    lastVisible?: any;
-    categoryId?: string;
-    subcategoryId?: string;
-    technologyId?: string;
-  }): Promise<{ products: Product[]; lastVisible: any }> {
-    const { rowsPerPage, lastVisible, categoryId, subcategoryId, technologyId } = options;
-
-    const constraints: QueryConstraint[] = [where('isActive', '==', true), orderBy('name')];
-
-    if (categoryId) {
-      constraints.push(where('categoryId', '==', categoryId));
-    }
-    if (subcategoryId) {
-      constraints.push(where('subcategoryId', '==', subcategoryId));
-    }
-    if (technologyId) {
-      constraints.push(where('technologyId', '==', technologyId));
-    }
-
-    if (lastVisible) {
-      constraints.push(startAfter(lastVisible));
-    }
-    constraints.push(limit(rowsPerPage));
-
-    const q = query(collectionGroup(this.db, PRODUCTS_COLLECTION), ...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 the total count of active products, with optional filters.
-   */
-  async getProductsCount(options: {
-    categoryId?: string;
-    subcategoryId?: string;
-    technologyId?: string;
-  }): Promise<number> {
-    const { categoryId, subcategoryId, technologyId } = options;
-    const constraints: QueryConstraint[] = [where('isActive', '==', true)];
-
-    if (categoryId) {
-      constraints.push(where('categoryId', '==', categoryId));
-    }
-    if (subcategoryId) {
-      constraints.push(where('subcategoryId', '==', subcategoryId));
-    }
-    if (technologyId) {
-      constraints.push(where('technologyId', '==', technologyId));
-    }
-
-    const q = query(collectionGroup(this.db, PRODUCTS_COLLECTION), ...constraints);
-    const snapshot = await getCountFromServer(q);
-    return snapshot.data().count;
-  }
-
-  /**
-   * Gets counts of active products grouped by category, subcategory, and technology.
-   * 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 counts = {
-      byCategory: {} as Record<string, number>,
-      bySubcategory: {} as Record<string, number>,
-      byTechnology: {} as Record<string, number>,
-    };
-
-    // 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;
-      
-      // Use legacy fields from subcollections
-      if (product.categoryId) {
-        counts.byCategory[product.categoryId] = (counts.byCategory[product.categoryId] || 0) + 1;
-      }
-      if (product.subcategoryId) {
-        counts.bySubcategory[product.subcategoryId] = (counts.bySubcategory[product.subcategoryId] || 0) + 1;
-      }
-      if (product.technologyId) {
-        counts.byTechnology[product.technologyId] = (counts.byTechnology[product.technologyId] || 0) + 1;
-      }
-    });
-
-    return counts;
-  }
-
-  /**
-   * Gets all products for a specific technology (non-paginated, for filters/dropdowns)
-   */
-  async getAllByTechnology(technologyId: string): Promise<Product[]> {
-    const q = query(
-      this.getProductsRef(technologyId),
-      where('isActive', '==', true),
-      orderBy('name'),
-    );
-    const snapshot = await getDocs(q);
-    return snapshot.docs.map(
-      doc =>
-        ({
-          id: doc.id,
-          ...doc.data(),
-        } as Product),
-    );
-  }
-
-  /**
-   * Gets all products for a brand by filtering through all technologies
-   */
-  async getAllByBrand(brandId: string): Promise<Product[]> {
-    const allTechnologiesRef = collection(this.db, TECHNOLOGIES_COLLECTION);
-    const technologiesSnapshot = await getDocs(allTechnologiesRef);
-
-    const products: Product[] = [];
-
-    for (const techDoc of technologiesSnapshot.docs) {
-      const q = query(
-        this.getProductsRef(techDoc.id),
-        where('brandId', '==', brandId),
-        where('isActive', '==', true),
-      );
-      const snapshot = await getDocs(q);
-      products.push(
-        ...snapshot.docs.map(
-          doc =>
-            ({
-              id: doc.id,
-              ...doc.data(),
-            } as Product),
-        ),
-      );
-    }
-
-    return products;
-  }
-
-  /**
-   * Updates a product
-   */
-  async update(
-    technologyId: string,
-    productId: string,
-    product: Partial<Omit<Product, 'id' | 'createdAt' | 'brandId' | 'technologyId'>>,
-  ): Promise<Product | null> {
-    const updateData = {
-      ...product,
-      updatedAt: new Date(),
-    };
-
-    const docRef = doc(this.getProductsRef(technologyId), productId);
-    await updateDoc(docRef, updateData);
-
-    return this.getById(technologyId, productId);
-  }
-
-  /**
-   * Soft deletes a product
-   */
-  async delete(technologyId: string, productId: string): Promise<void> {
-    await this.update(technologyId, productId, {
-      isActive: false,
-    });
-  }
-
-  /**
-   * Gets a product by ID
-   */
-  async getById(technologyId: string, productId: string): Promise<Product | null> {
-    const docRef = doc(this.getProductsRef(technologyId), productId);
-    const docSnap = await getDoc(docRef);
-    if (!docSnap.exists()) return null;
-    return {
-      id: docSnap.id,
-      ...docSnap.data(),
-    } as Product;
-  }
-
-  // ==========================================
-  // NEW METHODS: Top-level collection (preferred)
-  // ==========================================
-
-  /**
-   * Creates a new product in the top-level collection
-   */
-  async createTopLevel(
-    product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'assignedTechnologyIds'>,
-    technologyIds: string[] = [],
-  ): Promise<Product> {
-    const now = new Date();
-    const newProduct: Omit<Product, 'id'> = {
-      ...product,
-      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;
-    category?: string;
-  }): Promise<{ products: Product[]; lastVisible: any }> {
-    const { rowsPerPage, lastVisible, brandId, category } = options;
-
-    console.log('[ProductService.getAllTopLevel] Called with:', {
-      rowsPerPage,
-      hasLastVisible: !!lastVisible,
-      brandId: brandId || 'none',
-      category: category || 'none',
-    });
-
-    const constraints: QueryConstraint[] = [where('isActive', '==', true), orderBy('name')];
-
-    if (brandId) {
-      console.log('[ProductService.getAllTopLevel] Adding brandId filter:', brandId);
-      constraints.push(where('brandId', '==', brandId));
-    }
-
-    if (category) {
-      console.log('[ProductService.getAllTopLevel] Adding category filter:', category);
-      constraints.push(where('category', '==', category));
-    }
-
-    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'>>,
-  ): 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",
-      "category",
-      "assignedTechnologyIds",
-      "description",
-      "metadata",
-      "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.category ?? "",
-      product.assignedTechnologyIds?.join(";") ?? "",
-      product.description ?? "",
-      product.metadata ? JSON.stringify(product.metadata) : "",
-      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}"`;
-  }
-}
+import {
+  addDoc,
+  collection,
+  collectionGroup,
+  doc,
+  getDoc,
+  getDocs,
+  query,
+  updateDoc,
+  where,
+  limit,
+  orderBy,
+  startAfter,
+  getCountFromServer,
+  QueryConstraint,
+  arrayUnion,
+  arrayRemove,
+} from 'firebase/firestore';
+import { Product, PRODUCTS_COLLECTION, IProductService } from '../types/product.types';
+import { BaseService } from '../../services/base.service';
+import { TECHNOLOGIES_COLLECTION } from '../types/technology.types';
+
+export class ProductService extends BaseService implements IProductService {
+  /**
+   * 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
+   */
+  private getProductsRef(technologyId: string) {
+    return collection(this.db, TECHNOLOGIES_COLLECTION, technologyId, PRODUCTS_COLLECTION);
+  }
+
+  /**
+   * Creates a new product under technology
+   */
+  async create(
+    technologyId: string,
+    brandId: string,
+    product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'brandId' | 'technologyId'>,
+  ): Promise<Product> {
+    const now = new Date();
+    // Create product with legacy structure for subcollection compatibility
+    const newProduct: Omit<Product, 'id'> = {
+      ...product,
+      brandId,
+      technologyId, // Required for old subcollection structure
+      createdAt: now,
+      updatedAt: now,
+      isActive: true,
+    };
+
+    const productRef = await addDoc(this.getProductsRef(technologyId), newProduct);
+
+    return { id: productRef.id, ...newProduct };
+  }
+
+  /**
+   * Gets a paginated list of all products, with optional filters.
+   * This uses a collectionGroup query to search across all technologies.
+   */
+  async getAll(options: {
+    rowsPerPage: number;
+    lastVisible?: any;
+    categoryId?: string;
+    subcategoryId?: string;
+    technologyId?: string;
+  }): Promise<{ products: Product[]; lastVisible: any }> {
+    const { rowsPerPage, lastVisible, categoryId, subcategoryId, technologyId } = options;
+
+    const constraints: QueryConstraint[] = [where('isActive', '==', true), orderBy('name')];
+
+    if (categoryId) {
+      constraints.push(where('categoryId', '==', categoryId));
+    }
+    if (subcategoryId) {
+      constraints.push(where('subcategoryId', '==', subcategoryId));
+    }
+    if (technologyId) {
+      constraints.push(where('technologyId', '==', technologyId));
+    }
+
+    if (lastVisible) {
+      constraints.push(startAfter(lastVisible));
+    }
+    constraints.push(limit(rowsPerPage));
+
+    const q = query(collectionGroup(this.db, PRODUCTS_COLLECTION), ...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 the total count of active products, with optional filters.
+   */
+  async getProductsCount(options: {
+    categoryId?: string;
+    subcategoryId?: string;
+    technologyId?: string;
+  }): Promise<number> {
+    const { categoryId, subcategoryId, technologyId } = options;
+    const constraints: QueryConstraint[] = [where('isActive', '==', true)];
+
+    if (categoryId) {
+      constraints.push(where('categoryId', '==', categoryId));
+    }
+    if (subcategoryId) {
+      constraints.push(where('subcategoryId', '==', subcategoryId));
+    }
+    if (technologyId) {
+      constraints.push(where('technologyId', '==', technologyId));
+    }
+
+    const q = query(collectionGroup(this.db, PRODUCTS_COLLECTION), ...constraints);
+    const snapshot = await getCountFromServer(q);
+    return snapshot.data().count;
+  }
+
+  /**
+   * Gets counts of active products grouped by category, subcategory, and technology.
+   * 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 counts = {
+      byCategory: {} as Record<string, number>,
+      bySubcategory: {} as Record<string, number>,
+      byTechnology: {} as Record<string, number>,
+    };
+
+    // 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;
+      
+      // Use legacy fields from subcollections
+      if (product.categoryId) {
+        counts.byCategory[product.categoryId] = (counts.byCategory[product.categoryId] || 0) + 1;
+      }
+      if (product.subcategoryId) {
+        counts.bySubcategory[product.subcategoryId] = (counts.bySubcategory[product.subcategoryId] || 0) + 1;
+      }
+      if (product.technologyId) {
+        counts.byTechnology[product.technologyId] = (counts.byTechnology[product.technologyId] || 0) + 1;
+      }
+    });
+
+    return counts;
+  }
+
+  /**
+   * Gets all products for a specific technology (non-paginated, for filters/dropdowns)
+   */
+  async getAllByTechnology(technologyId: string): Promise<Product[]> {
+    const q = query(
+      this.getProductsRef(technologyId),
+      where('isActive', '==', true),
+      orderBy('name'),
+    );
+    const snapshot = await getDocs(q);
+    return snapshot.docs.map(
+      doc =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Product),
+    );
+  }
+
+  /**
+   * Gets all products for a brand by filtering through all technologies
+   */
+  async getAllByBrand(brandId: string): Promise<Product[]> {
+    const allTechnologiesRef = collection(this.db, TECHNOLOGIES_COLLECTION);
+    const technologiesSnapshot = await getDocs(allTechnologiesRef);
+
+    const products: Product[] = [];
+
+    for (const techDoc of technologiesSnapshot.docs) {
+      const q = query(
+        this.getProductsRef(techDoc.id),
+        where('brandId', '==', brandId),
+        where('isActive', '==', true),
+      );
+      const snapshot = await getDocs(q);
+      products.push(
+        ...snapshot.docs.map(
+          doc =>
+            ({
+              id: doc.id,
+              ...doc.data(),
+            } as Product),
+        ),
+      );
+    }
+
+    return products;
+  }
+
+  /**
+   * Updates a product
+   */
+  async update(
+    technologyId: string,
+    productId: string,
+    product: Partial<Omit<Product, 'id' | 'createdAt' | 'brandId' | 'technologyId'>>,
+  ): Promise<Product | null> {
+    const updateData = {
+      ...product,
+      updatedAt: new Date(),
+    };
+
+    const docRef = doc(this.getProductsRef(technologyId), productId);
+    await updateDoc(docRef, updateData);
+
+    return this.getById(technologyId, productId);
+  }
+
+  /**
+   * Soft deletes a product
+   */
+  async delete(technologyId: string, productId: string): Promise<void> {
+    await this.update(technologyId, productId, {
+      isActive: false,
+    });
+  }
+
+  /**
+   * Gets a product by ID
+   */
+  async getById(technologyId: string, productId: string): Promise<Product | null> {
+    const docRef = doc(this.getProductsRef(technologyId), productId);
+    const docSnap = await getDoc(docRef);
+    if (!docSnap.exists()) return null;
+    return {
+      id: docSnap.id,
+      ...docSnap.data(),
+    } as Product;
+  }
+
+  // ==========================================
+  // NEW METHODS: Top-level collection (preferred)
+  // ==========================================
+
+  /**
+   * Creates a new product in the top-level collection
+   */
+  async createTopLevel(
+    product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'assignedTechnologyIds'>,
+    technologyIds: string[] = [],
+  ): Promise<Product> {
+    const now = new Date();
+    const newProduct: Omit<Product, 'id'> = {
+      ...product,
+      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;
+    category?: string;
+  }): Promise<{ products: Product[]; lastVisible: any }> {
+    const { rowsPerPage, lastVisible, brandId, category } = options;
+
+    console.log('[ProductService.getAllTopLevel] Called with:', {
+      rowsPerPage,
+      hasLastVisible: !!lastVisible,
+      brandId: brandId || 'none',
+      category: category || 'none',
+    });
+
+    const constraints: QueryConstraint[] = [where('isActive', '==', true), orderBy('name')];
+
+    if (brandId) {
+      console.log('[ProductService.getAllTopLevel] Adding brandId filter:', brandId);
+      constraints.push(where('brandId', '==', brandId));
+    }
+
+    if (category) {
+      console.log('[ProductService.getAllTopLevel] Adding category filter:', category);
+      constraints.push(where('category', '==', category));
+    }
+
+    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'>>,
+  ): 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",
+      "category",
+      "assignedTechnologyIds",
+      "description",
+      "metadata",
+      "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.category ?? "",
+      product.assignedTechnologyIds?.join(";") ?? "",
+      product.description ?? "",
+      product.metadata ? JSON.stringify(product.metadata) : "",
+      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}"`;
+  }
+}