@blackcode_sa/metaestetics-api 1.12.39 → 1.12.41

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[];
+    /** @deprecated Use assignedTechnologyIds instead */
+    technologyId?: string;
+    /** @deprecated Will be removed in future version */
+    technologyName?: string;
+    /** @deprecated Not needed in top-level collection */
+    categoryId?: string;
+    /** @deprecated Not needed in top-level collection */
+    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
@@ -1480,7 +1560,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
      */
@@ -1512,8 +1597,9 @@ declare class ProductService extends BaseService implements IProductService {
         technologyId?: string;
     }): Promise<number>;
     /**
-     * Gets counts of active products grouped by category, subcategory, and technology.
-     * This uses a single collectionGroup query for efficiency.
+     * Gets counts of active products grouped by technology.
+     * NOTE: Only counts top-level collection to avoid duplication during migration.
+     * Categories/subcategories not available in top-level structure.
      */
     getProductCounts(): Promise<{
         byCategory: Record<string, number>;
@@ -1540,6 +1626,53 @@ 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[]>;
 }
 
 /**
@@ -1973,10 +2106,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 +2378,32 @@ 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>;
+    }>;
 }
 
 /**

package/dist/index.d.ts

@@ -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[];
+    /** @deprecated Use assignedTechnologyIds instead */
+    technologyId?: string;
+    /** @deprecated Will be removed in future version */
+    technologyName?: string;
+    /** @deprecated Not needed in top-level collection */
+    categoryId?: string;
+    /** @deprecated Not needed in top-level collection */
+    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
@@ -1480,7 +1560,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
      */
@@ -1512,8 +1597,9 @@ declare class ProductService extends BaseService implements IProductService {
         technologyId?: string;
     }): Promise<number>;
     /**
-     * Gets counts of active products grouped by category, subcategory, and technology.
-     * This uses a single collectionGroup query for efficiency.
+     * Gets counts of active products grouped by technology.
+     * NOTE: Only counts top-level collection to avoid duplication during migration.
+     * Categories/subcategories not available in top-level structure.
      */
     getProductCounts(): Promise<{
         byCategory: Record<string, number>;
@@ -1540,6 +1626,53 @@ 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[]>;
 }
 
 /**
@@ -1973,10 +2106,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 +2378,32 @@ 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>;
+    }>;
 }
 
 /**