@blackcode_sa/metaestetics-api 1.12.42 → 1.12.43

package/dist/index.mjs

@@ -18509,6 +18509,73 @@ var BrandService = class extends BaseService {
       ...docSnap.data()
     };
   }
+  /**
+   * 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) {
+    var _a, _b;
+    const includeInactive = (_a = options == null ? void 0 : options.includeInactive) != null ? _a : false;
+    const includeBom = (_b = options == null ? void 0 : options.includeBom) != null ? _b : true;
+    const headers = [
+      "id",
+      "name",
+      "manufacturer",
+      "website",
+      "description",
+      "isActive"
+    ];
+    const rows = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+    const PAGE_SIZE = 1e3;
+    let cursor;
+    const baseConstraints = [];
+    if (!includeInactive) {
+      baseConstraints.push(where33("isActive", "==", true));
+    }
+    baseConstraints.push(orderBy19("name_lowercase"));
+    while (true) {
+      const constraints = [...baseConstraints, limit17(PAGE_SIZE)];
+      if (cursor) constraints.push(startAfter15(cursor));
+      const q = query33(this.getBrandsRef(), ...constraints);
+      const snapshot = await getDocs33(q);
+      if (snapshot.empty) break;
+      for (const d of snapshot.docs) {
+        const brand = { id: d.id, ...d.data() };
+        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;
+  }
+  brandToCsvRow(brand) {
+    var _a, _b, _c, _d, _e, _f;
+    const values = [
+      (_a = brand.id) != null ? _a : "",
+      (_b = brand.name) != null ? _b : "",
+      (_c = brand.manufacturer) != null ? _c : "",
+      (_d = brand.website) != null ? _d : "",
+      (_e = brand.description) != null ? _e : "",
+      String((_f = brand.isActive) != null ? _f : "")
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+  formatDateIso(value) {
+    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 != null ? value : "");
+  }
+  formatCsvValue(value) {
+    const str = value === null || value === void 0 ? "" : String(value);
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 };
 
 // src/backoffice/services/category.service.ts
@@ -18700,6 +18767,71 @@ var CategoryService = class extends BaseService {
       ...docSnap.data()
     };
   }
+  /**
+   * 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) {
+    var _a, _b;
+    const includeInactive = (_a = options == null ? void 0 : options.includeInactive) != null ? _a : false;
+    const includeBom = (_b = options == null ? void 0 : options.includeBom) != null ? _b : true;
+    const headers = [
+      "id",
+      "name",
+      "description",
+      "family",
+      "isActive"
+    ];
+    const rows = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+    const PAGE_SIZE = 1e3;
+    let cursor;
+    const constraints = [];
+    if (!includeInactive) {
+      constraints.push(where34("isActive", "==", true));
+    }
+    constraints.push(orderBy20("name"));
+    while (true) {
+      const queryConstraints = [...constraints, limit18(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter16(cursor));
+      const q = query34(this.categoriesRef, ...queryConstraints);
+      const snapshot = await getDocs34(q);
+      if (snapshot.empty) break;
+      for (const d of snapshot.docs) {
+        const category = { id: d.id, ...d.data() };
+        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;
+  }
+  categoryToCsvRow(category) {
+    var _a, _b, _c, _d, _e;
+    const values = [
+      (_a = category.id) != null ? _a : "",
+      (_b = category.name) != null ? _b : "",
+      (_c = category.description) != null ? _c : "",
+      (_d = category.family) != null ? _d : "",
+      String((_e = category.isActive) != null ? _e : "")
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+  formatDateIso(value) {
+    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 != null ? value : "");
+  }
+  formatCsvValue(value) {
+    const str = value === null || value === void 0 ? "" : String(value);
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 };
 
 // src/backoffice/services/subcategory.service.ts
@@ -18943,6 +19075,74 @@ var SubcategoryService = class extends BaseService {
       ...docSnap.data()
     };
   }
+  /**
+   * 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) {
+    var _a, _b;
+    const includeInactive = (_a = options == null ? void 0 : options.includeInactive) != null ? _a : false;
+    const includeBom = (_b = options == null ? void 0 : options.includeBom) != null ? _b : true;
+    const headers = [
+      "id",
+      "name",
+      "categoryId",
+      "description",
+      "isActive"
+    ];
+    const rows = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+    const PAGE_SIZE = 1e3;
+    let cursor;
+    const constraints = [];
+    if (!includeInactive) {
+      constraints.push(where35("isActive", "==", true));
+    }
+    constraints.push(orderBy21("name"));
+    while (true) {
+      const queryConstraints = [...constraints, limit19(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter17(cursor));
+      const q = query35(
+        collectionGroup2(this.db, SUBCATEGORIES_COLLECTION),
+        ...queryConstraints
+      );
+      const snapshot = await getDocs35(q);
+      if (snapshot.empty) break;
+      for (const d of snapshot.docs) {
+        const subcategory = { id: d.id, ...d.data() };
+        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;
+  }
+  subcategoryToCsvRow(subcategory) {
+    var _a, _b, _c, _d, _e;
+    const values = [
+      (_a = subcategory.id) != null ? _a : "",
+      (_b = subcategory.name) != null ? _b : "",
+      (_c = subcategory.categoryId) != null ? _c : "",
+      (_d = subcategory.description) != null ? _d : "",
+      String((_e = subcategory.isActive) != null ? _e : "")
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+  formatDateIso(value) {
+    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 != null ? value : "");
+  }
+  formatCsvValue(value) {
+    const str = value === null || value === void 0 ? "" : String(value);
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 };
 
 // src/backoffice/services/technology.service.ts
@@ -19694,6 +19894,106 @@ var TechnologyService = class extends BaseService {
     }
     await batch.commit();
   }
+  /**
+   * Exports technologies to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active technologies (set includeInactive to true to export all).
+   * Includes product names from subcollections.
+   */
+  async exportToCsv(options) {
+    var _a, _b;
+    const includeInactive = (_a = options == null ? void 0 : options.includeInactive) != null ? _a : false;
+    const includeBom = (_b = options == null ? void 0 : options.includeBom) != null ? _b : true;
+    const headers = [
+      "id",
+      "name",
+      "description",
+      "family",
+      "categoryId",
+      "subcategoryId",
+      "technicalDetails",
+      "requirements_pre",
+      "requirements_post",
+      "blockingConditions",
+      "contraindications",
+      "benefits",
+      "certificationMinimumLevel",
+      "certificationRequiredSpecialties",
+      "documentationTemplateIds",
+      "productNames",
+      "isActive"
+    ];
+    const rows = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+    const PAGE_SIZE = 1e3;
+    let cursor;
+    const constraints = [];
+    if (!includeInactive) {
+      constraints.push(where36("isActive", "==", true));
+    }
+    constraints.push(orderBy22("name"));
+    while (true) {
+      const queryConstraints = [...constraints, limit20(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter18(cursor));
+      const q = query36(this.technologiesRef, ...queryConstraints);
+      const snapshot = await getDocs36(q);
+      if (snapshot.empty) break;
+      for (const d of snapshot.docs) {
+        const technology = { id: d.id, ...d.data() };
+        const productNames = await this.getProductNamesForTechnology(technology.id);
+        rows.push(this.technologyToCsvRow(technology, productNames));
+      }
+      cursor = snapshot.docs[snapshot.docs.length - 1];
+      if (snapshot.size < PAGE_SIZE) break;
+    }
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+  /**
+   * Gets product names from the technology's product subcollection
+   */
+  async getProductNamesForTechnology(technologyId) {
+    try {
+      const productsRef = collection36(this.db, TECHNOLOGIES_COLLECTION, technologyId, PRODUCTS_COLLECTION);
+      const q = query36(productsRef, where36("isActive", "==", true));
+      const snapshot = await getDocs36(q);
+      return snapshot.docs.map((doc44) => {
+        const product = doc44.data();
+        return product.name || "";
+      }).filter((name) => name);
+    } catch (error) {
+      console.error(`Error fetching products for technology ${technologyId}:`, error);
+      return [];
+    }
+  }
+  technologyToCsvRow(technology, productNames = []) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A;
+    const values = [
+      (_a = technology.id) != null ? _a : "",
+      (_b = technology.name) != null ? _b : "",
+      (_c = technology.description) != null ? _c : "",
+      (_d = technology.family) != null ? _d : "",
+      (_e = technology.categoryId) != null ? _e : "",
+      (_f = technology.subcategoryId) != null ? _f : "",
+      (_g = technology.technicalDetails) != null ? _g : "",
+      (_j = (_i = (_h = technology.requirements) == null ? void 0 : _h.pre) == null ? void 0 : _i.map((r) => r.name).join(";")) != null ? _j : "",
+      (_m = (_l = (_k = technology.requirements) == null ? void 0 : _k.post) == null ? void 0 : _l.map((r) => r.name).join(";")) != null ? _m : "",
+      (_o = (_n = technology.blockingConditions) == null ? void 0 : _n.join(";")) != null ? _o : "",
+      (_q = (_p = technology.contraindications) == null ? void 0 : _p.map((c) => c.name).join(";")) != null ? _q : "",
+      (_s = (_r = technology.benefits) == null ? void 0 : _r.map((b) => b.name).join(";")) != null ? _s : "",
+      (_u = (_t = technology.certificationRequirement) == null ? void 0 : _t.minimumLevel) != null ? _u : "",
+      (_x = (_w = (_v = technology.certificationRequirement) == null ? void 0 : _v.requiredSpecialties) == null ? void 0 : _w.join(";")) != null ? _x : "",
+      (_z = (_y = technology.documentationTemplates) == null ? void 0 : _y.map((t) => t.templateId).join(";")) != null ? _z : "",
+      productNames.join(";"),
+      String((_A = technology.isActive) != null ? _A : "")
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+  formatCsvValue(value) {
+    const str = value === null || value === void 0 ? "" : String(value);
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 };
 
 // src/backoffice/services/product.service.ts
@@ -20051,6 +20351,87 @@ var ProductService = class extends BaseService {
       })
     );
   }
+  /**
+   * 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) {
+    var _a, _b;
+    const includeInactive = (_a = options == null ? void 0 : options.includeInactive) != null ? _a : false;
+    const includeBom = (_b = options == null ? void 0 : options.includeBom) != null ? _b : true;
+    const headers = [
+      "id",
+      "name",
+      "brandId",
+      "brandName",
+      "assignedTechnologyIds",
+      "description",
+      "technicalDetails",
+      "dosage",
+      "composition",
+      "indications",
+      "contraindications",
+      "warnings",
+      "isActive"
+    ];
+    const rows = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+    const PAGE_SIZE = 1e3;
+    let cursor;
+    const constraints = [];
+    if (!includeInactive) {
+      constraints.push(where37("isActive", "==", true));
+    }
+    constraints.push(orderBy23("name"));
+    while (true) {
+      const queryConstraints = [...constraints, limit21(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter19(cursor));
+      const q = query37(this.getTopLevelProductsRef(), ...queryConstraints);
+      const snapshot = await getDocs37(q);
+      if (snapshot.empty) break;
+      for (const d of snapshot.docs) {
+        const product = { id: d.id, ...d.data() };
+        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;
+  }
+  productToCsvRow(product) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q;
+    const values = [
+      (_a = product.id) != null ? _a : "",
+      (_b = product.name) != null ? _b : "",
+      (_c = product.brandId) != null ? _c : "",
+      (_d = product.brandName) != null ? _d : "",
+      (_f = (_e = product.assignedTechnologyIds) == null ? void 0 : _e.join(";")) != null ? _f : "",
+      (_g = product.description) != null ? _g : "",
+      (_h = product.technicalDetails) != null ? _h : "",
+      (_i = product.dosage) != null ? _i : "",
+      (_j = product.composition) != null ? _j : "",
+      (_l = (_k = product.indications) == null ? void 0 : _k.join(";")) != null ? _l : "",
+      (_n = (_m = product.contraindications) == null ? void 0 : _m.map((c) => c.name).join(";")) != null ? _n : "",
+      (_p = (_o = product.warnings) == null ? void 0 : _o.join(";")) != null ? _p : "",
+      String((_q = product.isActive) != null ? _q : "")
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+  formatDateIso(value) {
+    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 != null ? value : "");
+  }
+  formatCsvValue(value) {
+    const str = value === null || value === void 0 ? "" : String(value);
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 };
 
 // src/backoffice/services/constants.service.ts
@@ -20290,6 +20671,66 @@ var ConstantsService = class extends BaseService {
       contraindications: arrayRemove10(toRemove)
     });
   }
+  // =================================================================
+  // CSV Export Methods
+  // =================================================================
+  /**
+   * Exports treatment benefits to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   */
+  async exportBenefitsToCsv(options) {
+    var _a;
+    const includeBom = (_a = options == null ? void 0 : options.includeBom) != null ? _a : true;
+    const headers = ["id", "name", "description"];
+    const rows = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+    const benefits = await this.getAllBenefitsForFilter();
+    for (const benefit of benefits) {
+      rows.push(this.benefitToCsvRow(benefit));
+    }
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+  /**
+   * Exports contraindications to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   */
+  async exportContraindicationsToCsv(options) {
+    var _a;
+    const includeBom = (_a = options == null ? void 0 : options.includeBom) != null ? _a : true;
+    const headers = ["id", "name", "description"];
+    const rows = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+    const contraindications = await this.getAllContraindicationsForFilter();
+    for (const contraindication of contraindications) {
+      rows.push(this.contraindicationToCsvRow(contraindication));
+    }
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+  benefitToCsvRow(benefit) {
+    var _a, _b, _c;
+    const values = [
+      (_a = benefit.id) != null ? _a : "",
+      (_b = benefit.name) != null ? _b : "",
+      (_c = benefit.description) != null ? _c : ""
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+  contraindicationToCsvRow(contraindication) {
+    var _a, _b, _c;
+    const values = [
+      (_a = contraindication.id) != null ? _a : "",
+      (_b = contraindication.name) != null ? _b : "",
+      (_c = contraindication.description) != null ? _c : ""
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+  formatCsvValue(value) {
+    const str = value === null || value === void 0 ? "" : String(value);
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 };
 
 // src/backoffice/types/static/contraindication.types.ts

package/package.json

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

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

@@ -167,4 +167,90 @@ export class BrandService extends BaseService {
       ...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}"`;
+  }
 }

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

@@ -231,4 +231,88 @@ export class CategoryService extends BaseService implements ICategoryService {
       ...docSnap.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) {
+        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}"`;
+  }
 }