@blackcode_sa/metaestetics-api 1.12.43 → 1.12.45

package/dist/index.d.mts

@@ -565,10 +565,9 @@ interface FilledDocumentFileValue {
  *
  * @property id - Unique identifier of the product
  * @property name - Name of the product
- * @property brandId - ID of the brand that manufactures this product
- * @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 brandId - ID of the brand that manufactures this product
+ * @property technologyId - ID of the technology this product is used with
  * @property technicalDetails - Technical details and specifications
  * @property warnings - List of warnings related to product use
  * @property dosage - Dosage information (if applicable)
@@ -584,7 +583,10 @@ interface Product {
     name: string;
     brandId: string;
     brandName: string;
-    assignedTechnologyIds?: string[];
+    technologyId: string;
+    technologyName: string;
+    categoryId: string;
+    subcategoryId: string;
     createdAt: Date;
     updatedAt: Date;
     isActive: boolean;
@@ -595,86 +597,12 @@ 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
@@ -682,7 +610,6 @@ 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: {
@@ -696,7 +623,6 @@ interface IProductService {
         lastVisible: any;
     }>;
     /**
-     * @deprecated Use alternative counting methods
      * Gets the total count of active products, with optional filters.
      */
     getProductsCount(options: {
@@ -705,7 +631,6 @@ interface IProductService {
         technologyId?: string;
     }): Promise<number>;
     /**
-     * @deprecated Use alternative counting methods
      * Gets counts of active products grouped by category, subcategory, and technology.
      */
     getProductCounts(): Promise<{
@@ -714,19 +639,16 @@ 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
@@ -734,14 +656,12 @@ 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
@@ -1183,18 +1103,6 @@ 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;
 }
 
 /**
@@ -1296,18 +1204,6 @@ 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;
 }
 
 /**
@@ -1584,12 +1480,7 @@ declare class FilledDocumentService extends BaseService {
 
 declare class ProductService extends BaseService implements IProductService {
     /**
-     * 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)
+     * Gets reference to products collection under a technology
      * @param technologyId - ID of the technology
      * @returns Firestore collection reference
      */
@@ -1622,7 +1513,7 @@ declare class ProductService extends BaseService implements IProductService {
     }): Promise<number>;
     /**
      * Gets counts of active products grouped by category, subcategory, and technology.
-     * Queries technology subcollections which have the legacy fields synced by Cloud Functions.
+     * This uses a single collectionGroup query for efficiency.
      */
     getProductCounts(): Promise<{
         byCategory: Record<string, number>;
@@ -1649,65 +1540,6 @@ 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;
 }
 
 /**
@@ -1818,18 +1650,6 @@ 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;
 }
 
 /**
@@ -2153,10 +1973,10 @@ declare class TechnologyService extends BaseService implements ITechnologyServic
         description: string;
         family: ProcedureFamily;
         isActive: boolean;
-        technicalDetails?: string | undefined;
-        contraindications: ContraindicationDynamic[];
         categoryId: string;
         subcategoryId: string;
+        technicalDetails?: string | undefined;
+        contraindications: ContraindicationDynamic[];
         requirements: {
             pre: Requirement[];
             post: Requirement[];
@@ -2425,54 +2245,6 @@ 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;
 }
 
 /**
@@ -2592,23 +2364,6 @@ 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;
 }
 
 /**