@blackcode_sa/metaestetics-api 1.12.50 → 1.12.51

package/dist/backoffice/index.d.ts

@@ -98,6 +98,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;
 }
 
 /**
@@ -277,6 +289,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;
 }
 
 /**
@@ -581,9 +605,10 @@ interface UpdateDocumentTemplateData {
  *
  * @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)
@@ -599,10 +624,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;
@@ -613,6 +635,14 @@ 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;
 }
 /**
  * Collection in Firestore database where products are stored
@@ -620,9 +650,75 @@ interface Product {
 declare const PRODUCTS_COLLECTION = "products";
 /**
  * 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
@@ -630,6 +726,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: {
@@ -643,6 +740,7 @@ interface IProductService {
         lastVisible: any;
     }>;
     /**
+     * @deprecated Use alternative counting methods
      * Gets the total count of active products, with optional filters.
      */
     getProductsCount(options: {
@@ -651,6 +749,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<{
@@ -659,16 +758,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
@@ -676,12 +778,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
@@ -1468,7 +1572,12 @@ declare class DocumentationTemplateServiceBackoffice {
 
 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
      */
@@ -1501,7 +1610,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>;
@@ -1528,6 +1637,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;
 }
 
 /**
@@ -1608,6 +1776,18 @@ declare class RequirementService extends BaseService {
      * @returns Zahtev ili null ako ne postoji
      */
     getById(id: string): Promise<Requirement | null>;
+    /**
+     * 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).
+     */
+    exportToCsv(options?: {
+        includeInactive?: boolean;
+        includeBom?: boolean;
+    }): Promise<string>;
+    private requirementToCsvRow;
+    private formatDateIso;
+    private formatCsvValue;
 }
 
 /**
@@ -1718,6 +1898,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;
 }
 
 /**
@@ -1740,10 +1932,10 @@ declare class TechnologyService extends BaseService implements ITechnologyServic
         isActive: boolean;
         description: string;
         family: ProcedureFamily;
-        categoryId: string;
-        subcategoryId: string;
         technicalDetails?: string | undefined;
         contraindications: ContraindicationDynamic[];
+        categoryId: string;
+        subcategoryId: string;
         requirements: {
             pre: Requirement[];
             post: Requirement[];
@@ -2012,6 +2204,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;
 }
 
 /**
@@ -2131,6 +2371,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;
 }
 
 declare const documentElementSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -4825,13 +5082,13 @@ declare const technologySchema: z.ZodObject<{
     name: string;
     isActive: boolean;
     family: ProcedureFamily;
-    categoryId: string;
-    subcategoryId: string;
     contraindications: {
         id: string;
         name: string;
         description?: string | undefined;
     }[];
+    categoryId: string;
+    subcategoryId: string;
     requirements: {
         pre: {
             name: string;
@@ -4970,13 +5227,13 @@ declare const technologySchema: z.ZodObject<{
 }, {
     name: string;
     family: ProcedureFamily;
-    categoryId: string;
-    subcategoryId: string;
     contraindications: {
         id: string;
         name: string;
         description?: string | undefined;
     }[];
+    categoryId: string;
+    subcategoryId: string;
     blockingConditions: BlockingCondition[];
     benefits: {
         id: string;
@@ -5839,14 +6096,14 @@ declare const technologyUpdateSchema: z.ZodObject<{
     isActive?: boolean | undefined;
     description?: string | undefined;
     family?: ProcedureFamily | undefined;
-    categoryId?: string | undefined;
-    subcategoryId?: string | undefined;
     technicalDetails?: string | undefined;
     contraindications?: {
         id: string;
         name: string;
         description?: string | undefined;
     }[] | undefined;
+    categoryId?: string | undefined;
+    subcategoryId?: string | undefined;
     requirements?: {
         pre: {
             name: string;
@@ -5985,14 +6242,14 @@ declare const technologyUpdateSchema: z.ZodObject<{
     isActive?: boolean | undefined;
     description?: string | undefined;
     family?: ProcedureFamily | undefined;
-    categoryId?: string | undefined;
-    subcategoryId?: string | undefined;
     technicalDetails?: string | undefined;
     contraindications?: {
         id: string;
         name: string;
         description?: string | undefined;
     }[] | undefined;
+    categoryId?: string | undefined;
+    subcategoryId?: string | undefined;
     requirements?: {
         pre: {
             name: string;