@blackcode_sa/metaestetics-api 1.13.5 → 1.13.8

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

@@ -1,256 +1,256 @@
-import {
-  addDoc,
-  collection,
-  doc,
-  getDoc,
-  getDocs,
-  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";
-
-export class BrandService extends BaseService {
-  /**
-   * Gets reference to brands collection
-   */
-  private getBrandsRef() {
-    return collection(this.db, BRANDS_COLLECTION);
-  }
-
-  /**
-   * Creates a new brand
-   */
-  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,
-    };
-
-    const docRef = await addDoc(this.getBrandsRef(), newBrand);
-    return { id: docRef.id, ...newBrand };
-  }
-
-  /**
-   * 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 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) =>
-        ({
-          id: doc.id,
-          ...doc.data(),
-        } as Brand)
-    );
-  }
-
-  /**
-   * Updates a brand
-   */
-  async update(
-    brandId: string,
-    brand: Partial<Omit<Brand, "id" | "createdAt" | "name_lowercase">>
-  ) {
-    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);
-  }
-
-  /**
-   * Soft deletes a brand
-   */
-  async delete(brandId: string) {
-    await this.update(brandId, {
-      isActive: false,
-    });
-  }
-
-  /**
-   * Gets a brand by ID
-   */
-  async getById(brandId: string): Promise<Brand | null> {
-    const docRef = doc(this.getBrandsRef(), brandId);
-    const docSnap = await getDoc(docRef);
-    if (!docSnap.exists()) return null;
-    return {
-      id: docSnap.id,
-      ...docSnap.data(),
-    } as Brand;
-  }
-
-  /**
-   * Exports brands to CSV string, suitable for Excel/Sheets.
-   * Includes headers and optional UTF-8 BOM.
-   * By default exports only active brands (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",
-      "manufacturer",
-      "website",
-      "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 baseConstraints: QueryConstraint[] = [];
-    if (!includeInactive) {
-      baseConstraints.push(where("isActive", "==", true));
-    }
-    baseConstraints.push(orderBy("name_lowercase"));
-
-    // Page through all results
-    // eslint-disable-next-line no-constant-condition
-    while (true) {
-      const constraints: QueryConstraint[] = [...baseConstraints, limit(PAGE_SIZE)];
-      if (cursor) constraints.push(startAfter(cursor));
-
-      const q = query(this.getBrandsRef(), ...constraints);
-      const snapshot = await getDocs(q);
-      if (snapshot.empty) break;
-
-      for (const d of snapshot.docs) {
-        const brand = ({ id: d.id, ...d.data() } as unknown) as Brand;
-        rows.push(this.brandToCsvRow(brand));
-      }
-
-      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 brandToCsvRow(brand: Brand): string {
-    const values = [
-      brand.id ?? "",
-      brand.name ?? "",
-      brand.manufacturer ?? "",
-      brand.website ?? "",
-      brand.description ?? "",
-      String(brand.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,
+  getDoc,
+  getDocs,
+  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";
+
+export class BrandService extends BaseService {
+  /**
+   * Gets reference to brands collection
+   */
+  private getBrandsRef() {
+    return collection(this.db, BRANDS_COLLECTION);
+  }
+
+  /**
+   * Creates a new brand
+   */
+  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,
+    };
+
+    const docRef = await addDoc(this.getBrandsRef(), newBrand);
+    return { id: docRef.id, ...newBrand };
+  }
+
+  /**
+   * 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 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) =>
+        ({
+          id: doc.id,
+          ...doc.data(),
+        } as Brand)
+    );
+  }
+
+  /**
+   * Updates a brand
+   */
+  async update(
+    brandId: string,
+    brand: Partial<Omit<Brand, "id" | "createdAt" | "name_lowercase">>
+  ) {
+    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);
+  }
+
+  /**
+   * Soft deletes a brand
+   */
+  async delete(brandId: string) {
+    await this.update(brandId, {
+      isActive: false,
+    });
+  }
+
+  /**
+   * Gets a brand by ID
+   */
+  async getById(brandId: string): Promise<Brand | null> {
+    const docRef = doc(this.getBrandsRef(), brandId);
+    const docSnap = await getDoc(docRef);
+    if (!docSnap.exists()) return null;
+    return {
+      id: docSnap.id,
+      ...docSnap.data(),
+    } as Brand;
+  }
+
+  /**
+   * Exports brands to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active brands (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",
+      "manufacturer",
+      "website",
+      "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 baseConstraints: QueryConstraint[] = [];
+    if (!includeInactive) {
+      baseConstraints.push(where("isActive", "==", true));
+    }
+    baseConstraints.push(orderBy("name_lowercase"));
+
+    // Page through all results
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+      const constraints: QueryConstraint[] = [...baseConstraints, limit(PAGE_SIZE)];
+      if (cursor) constraints.push(startAfter(cursor));
+
+      const q = query(this.getBrandsRef(), ...constraints);
+      const snapshot = await getDocs(q);
+      if (snapshot.empty) break;
+
+      for (const d of snapshot.docs) {
+        const brand = ({ id: d.id, ...d.data() } as unknown) as Brand;
+        rows.push(this.brandToCsvRow(brand));
+      }
+
+      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 brandToCsvRow(brand: Brand): string {
+    const values = [
+      brand.id ?? "",
+      brand.name ?? "",
+      brand.manufacturer ?? "",
+      brand.website ?? "",
+      brand.description ?? "",
+      String(brand.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}"`;
+  }
+}