@blackcode_sa/metaestetics-api 1.12.49 → 1.12.51

package/dist/index.d.mts

@@ -565,9 +565,10 @@ interface FilledDocumentFileValue {
  *
  * @property id - Unique identifier of the product
  * @property name - Name of the product
- * @property description - Detailed description of the product and its purpose
  * @property brandId - ID of the brand that manufactures this product
- * @property technologyId - ID of the technology this product is used with
+ * @property brandName - Name of the brand (denormalized for display)
+ * @property assignedTechnologyIds - Array of technology IDs this product is assigned to
+ * @property description - Detailed description of the product and its purpose
  * @property technicalDetails - Technical details and specifications
  * @property warnings - List of warnings related to product use
  * @property dosage - Dosage information (if applicable)
@@ -583,10 +584,7 @@ interface Product {
     name: string;
     brandId: string;
     brandName: string;
-    technologyId: string;
-    technologyName: string;
-    categoryId: string;
-    subcategoryId: string;
+    assignedTechnologyIds?: string[];
     createdAt: Date;
     updatedAt: Date;
     isActive: boolean;
@@ -597,12 +595,86 @@ interface Product {
     composition?: string;
     indications?: string[];
     contraindications?: ContraindicationDynamic[];
+    /** Present only in subcollections - synced from technology metadata */
+    technologyId?: string;
+    /** Present only in subcollections - synced from technology name */
+    technologyName?: string;
+    /** Present only in subcollections - synced from technology categoryId */
+    categoryId?: string;
+    /** Present only in subcollections - synced from technology subcategoryId */
+    subcategoryId?: string;
 }
 /**
  * Interface for the ProductService class
+ *
+ * NOTE: This interface maintains backward compatibility while adding new top-level collection methods.
+ * Old methods using technologyId are kept for existing code, new methods work with top-level collection.
  */
 interface IProductService {
     /**
+     * Creates a new product in the top-level collection
+     * @param brandId - ID of the brand that manufactures this product
+     * @param product - Product data
+     * @param technologyIds - Optional array of technology IDs to assign this product to
+     */
+    createTopLevel(brandId: string, product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'brandId' | 'assignedTechnologyIds'>, technologyIds?: string[]): Promise<Product>;
+    /**
+     * Gets all products from the top-level collection
+     * @param options - Query options
+     */
+    getAllTopLevel(options: {
+        rowsPerPage: number;
+        lastVisible?: any;
+        brandId?: string;
+    }): Promise<{
+        products: Product[];
+        lastVisible: any;
+    }>;
+    /**
+     * Gets a product by ID from the top-level collection
+     * @param productId - ID of the product
+     */
+    getByIdTopLevel(productId: string): Promise<Product | null>;
+    /**
+     * Updates a product in the top-level collection
+     * @param productId - ID of the product to update
+     * @param product - Updated product data
+     */
+    updateTopLevel(productId: string, product: Partial<Omit<Product, 'id' | 'createdAt' | 'brandId'>>): Promise<Product | null>;
+    /**
+     * Deletes a product from the top-level collection (soft delete)
+     * @param productId - ID of the product to delete
+     */
+    deleteTopLevel(productId: string): Promise<void>;
+    /**
+     * Assigns a product to a technology
+     * @param productId - ID of the product
+     * @param technologyId - ID of the technology
+     */
+    assignToTechnology(productId: string, technologyId: string): Promise<void>;
+    /**
+     * Unassigns a product from a technology
+     * @param productId - ID of the product
+     * @param technologyId - ID of the technology
+     */
+    unassignFromTechnology(productId: string, technologyId: string): Promise<void>;
+    /**
+     * Gets products assigned to a specific technology
+     * @param technologyId - ID of the technology
+     */
+    getAssignedProducts(technologyId: string): Promise<Product[]>;
+    /**
+     * Gets products NOT assigned to a specific technology
+     * @param technologyId - ID of the technology
+     */
+    getUnassignedProducts(technologyId: string): Promise<Product[]>;
+    /**
+     * Gets all products for a brand
+     * @param brandId - ID of the brand
+     */
+    getByBrand(brandId: string): Promise<Product[]>;
+    /**
+     * @deprecated Use createTopLevel instead
      * Creates a new product
      * @param technologyId - ID of the technology this product is used with
      * @param brandId - ID of the brand that manufactures this product
@@ -610,6 +682,7 @@ interface IProductService {
      */
     create(technologyId: string, brandId: string, product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'brandId' | 'technologyId'>): Promise<Product>;
     /**
+     * @deprecated Use getAllTopLevel instead
      * Gets a paginated list of all products, with optional filters.
      */
     getAll(options: {
@@ -623,6 +696,7 @@ interface IProductService {
         lastVisible: any;
     }>;
     /**
+     * @deprecated Use alternative counting methods
      * Gets the total count of active products, with optional filters.
      */
     getProductsCount(options: {
@@ -631,6 +705,7 @@ interface IProductService {
         technologyId?: string;
     }): Promise<number>;
     /**
+     * @deprecated Use alternative counting methods
      * Gets counts of active products grouped by category, subcategory, and technology.
      */
     getProductCounts(): Promise<{
@@ -639,16 +714,19 @@ interface IProductService {
         byTechnology: Record<string, number>;
     }>;
     /**
+     * @deprecated Use getAssignedProducts instead
      * Gets all products for a specific technology (non-paginated, for filters/dropdowns)
      * @param technologyId - ID of the technology
      */
     getAllByTechnology(technologyId: string): Promise<Product[]>;
     /**
+     * @deprecated Use getByBrand instead
      * Gets all products for a brand
      * @param brandId - ID of the brand
      */
     getAllByBrand(brandId: string): Promise<Product[]>;
     /**
+     * @deprecated Use updateTopLevel instead
      * Updates a product
      * @param technologyId - ID of the technology
      * @param productId - ID of the product to update
@@ -656,12 +734,14 @@ interface IProductService {
      */
     update(technologyId: string, productId: string, product: Partial<Omit<Product, 'id' | 'createdAt' | 'brandId' | 'technologyId'>>): Promise<Product | null>;
     /**
+     * @deprecated Use deleteTopLevel instead
      * Deletes a product (soft delete)
      * @param technologyId - ID of the technology
      * @param productId - ID of the product to delete
      */
     delete(technologyId: string, productId: string): Promise<void>;
     /**
+     * @deprecated Use getByIdTopLevel instead
      * Gets a product by ID
      * @param technologyId - ID of the technology
      * @param productId - ID of the product
@@ -1103,6 +1183,18 @@ declare class BrandService extends BaseService {
      * Gets a brand by ID
      */
     getById(brandId: string): Promise<Brand | null>;
+    /**
+     * 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).
+     */
+    exportToCsv(options?: {
+        includeInactive?: boolean;
+        includeBom?: boolean;
+    }): Promise<string>;
+    private brandToCsvRow;
+    private formatDateIso;
+    private formatCsvValue;
 }
 
 /**
@@ -1204,6 +1296,18 @@ declare class CategoryService extends BaseService implements ICategoryService {
      * @returns Kategorija ili null ako ne postoji
      */
     getById(id: string): Promise<Category | null>;
+    /**
+     * 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).
+     */
+    exportToCsv(options?: {
+        includeInactive?: boolean;
+        includeBom?: boolean;
+    }): Promise<string>;
+    private categoryToCsvRow;
+    private formatDateIso;
+    private formatCsvValue;
 }
 
 /**
@@ -1480,7 +1584,12 @@ declare class FilledDocumentService extends BaseService {
 
 declare 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;
+    /**
+     * Gets reference to products collection under a technology (backward compatibility)
      * @param technologyId - ID of the technology
      * @returns Firestore collection reference
      */
@@ -1513,7 +1622,7 @@ declare class ProductService extends BaseService implements IProductService {
     }): Promise<number>;
     /**
      * 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.
      */
     getProductCounts(): Promise<{
         byCategory: Record<string, number>;
@@ -1540,6 +1649,65 @@ declare class ProductService extends BaseService implements IProductService {
      * Gets a product by ID
      */
     getById(technologyId: string, productId: string): Promise<Product | null>;
+    /**
+     * Creates a new product in the top-level collection
+     */
+    createTopLevel(brandId: string, product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'brandId' | 'assignedTechnologyIds'>, technologyIds?: string[]): Promise<Product>;
+    /**
+     * Gets all products from the top-level collection
+     */
+    getAllTopLevel(options: {
+        rowsPerPage: number;
+        lastVisible?: any;
+        brandId?: string;
+    }): Promise<{
+        products: Product[];
+        lastVisible: any;
+    }>;
+    /**
+     * Gets a product by ID from the top-level collection
+     */
+    getByIdTopLevel(productId: string): Promise<Product | null>;
+    /**
+     * Updates a product in the top-level collection
+     */
+    updateTopLevel(productId: string, product: Partial<Omit<Product, 'id' | 'createdAt' | 'brandId'>>): Promise<Product | null>;
+    /**
+     * Deletes a product from the top-level collection (soft delete)
+     */
+    deleteTopLevel(productId: string): Promise<void>;
+    /**
+     * Assigns a product to a technology
+     */
+    assignToTechnology(productId: string, technologyId: string): Promise<void>;
+    /**
+     * Unassigns a product from a technology
+     */
+    unassignFromTechnology(productId: string, technologyId: string): Promise<void>;
+    /**
+     * Gets products assigned to a specific technology
+     */
+    getAssignedProducts(technologyId: string): Promise<Product[]>;
+    /**
+     * Gets products NOT assigned to a specific technology
+     */
+    getUnassignedProducts(technologyId: string): Promise<Product[]>;
+    /**
+     * Gets all products for a brand (from top-level collection)
+     */
+    getByBrand(brandId: string): Promise<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).
+     */
+    exportToCsv(options?: {
+        includeInactive?: boolean;
+        includeBom?: boolean;
+    }): Promise<string>;
+    private productToCsvRow;
+    private formatDateIso;
+    private formatCsvValue;
 }
 
 /**
@@ -1650,6 +1818,18 @@ declare class SubcategoryService extends BaseService {
      * @returns Podkategorija ili null ako ne postoji
      */
     getById(categoryId: string, subcategoryId: string): Promise<Subcategory | null>;
+    /**
+     * 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).
+     */
+    exportToCsv(options?: {
+        includeInactive?: boolean;
+        includeBom?: boolean;
+    }): Promise<string>;
+    private subcategoryToCsvRow;
+    private formatDateIso;
+    private formatCsvValue;
 }
 
 /**
@@ -1973,10 +2153,10 @@ declare class TechnologyService extends BaseService implements ITechnologyServic
         description: string;
         family: ProcedureFamily;
         isActive: boolean;
-        categoryId: string;
-        subcategoryId: string;
         technicalDetails?: string | undefined;
         contraindications: ContraindicationDynamic[];
+        categoryId: string;
+        subcategoryId: string;
         requirements: {
             pre: Requirement[];
             post: Requirement[];
@@ -2245,6 +2425,54 @@ declare class TechnologyService extends BaseService implements ITechnologyServic
      * Gets all active technologies for filter dropdowns.
      */
     getAllForFilter(): Promise<Technology[]>;
+    /**
+     * Assigns multiple products to a technology
+     * Updates each product's assignedTechnologyIds array
+     */
+    assignProducts(technologyId: string, productIds: string[]): Promise<void>;
+    /**
+     * Unassigns multiple products from a technology
+     * Updates each product's assignedTechnologyIds array
+     */
+    unassignProducts(technologyId: string, productIds: string[]): Promise<void>;
+    /**
+     * Gets products assigned to a specific technology
+     * Reads from top-level collection for immediate consistency (Cloud Functions may lag)
+     */
+    getAssignedProducts(technologyId: string): Promise<Product[]>;
+    /**
+     * Gets products NOT assigned to a specific technology
+     */
+    getUnassignedProducts(technologyId: string): Promise<Product[]>;
+    /**
+     * Gets product assignment statistics for a technology
+     */
+    getProductStats(technologyId: string): Promise<{
+        totalAssigned: number;
+        byBrand: Record<string, number>;
+    }>;
+    /**
+     * Updates products in technology subcollection when technology metadata changes
+     * @param technologyId - ID of the technology
+     * @param updates - Fields to update (categoryId, subcategoryId, technologyName)
+     */
+    private updateProductsInSubcollection;
+    /**
+     * 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.
+     */
+    exportToCsv(options?: {
+        includeInactive?: boolean;
+        includeBom?: boolean;
+    }): Promise<string>;
+    /**
+     * Gets product names from the technology's product subcollection
+     */
+    private getProductNamesForTechnology;
+    private technologyToCsvRow;
+    private formatCsvValue;
 }
 
 /**
@@ -2364,6 +2592,23 @@ declare class ConstantsService extends BaseService {
      * @returns {Promise<void>}
      */
     deleteContraindication(contraindicationId: string): Promise<void>;
+    /**
+     * Exports treatment benefits to CSV string, suitable for Excel/Sheets.
+     * Includes headers and optional UTF-8 BOM.
+     */
+    exportBenefitsToCsv(options?: {
+        includeBom?: boolean;
+    }): Promise<string>;
+    /**
+     * Exports contraindications to CSV string, suitable for Excel/Sheets.
+     * Includes headers and optional UTF-8 BOM.
+     */
+    exportContraindicationsToCsv(options?: {
+        includeBom?: boolean;
+    }): Promise<string>;
+    private benefitToCsvRow;
+    private contraindicationToCsvRow;
+    private formatCsvValue;
 }
 
 /**