@blackcode_sa/metaestetics-api 1.13.5 → 1.13.8

package/src/backoffice/services/documentation-template.service.ts

@@ -1,202 +1,202 @@
-import { Auth } from "firebase/auth";
-import { Firestore } from "firebase/firestore";
-import { FirebaseApp } from "firebase/app";
-import { DocumentationTemplateService as ApiDocumentationTemplateService } from "../../services/documentation-templates";
-import {
-  CreateDocumentTemplateData,
-  DocumentTemplate,
-  UpdateDocumentTemplateData,
-} from "../../types/documentation-templates";
-import { QueryDocumentSnapshot } from "firebase/firestore";
-
-/**
- * Service for managing documentation templates in the backoffice
- */
-export class DocumentationTemplateServiceBackoffice {
-  private apiService: ApiDocumentationTemplateService;
-
-  /**
-   * Constructor for DocumentationTemplateService
-   * @param db - Firestore instance
-   * @param auth - Firebase Auth instance
-   * @param app - Firebase App instance
-   */
-  constructor(
-    ...args: ConstructorParameters<typeof ApiDocumentationTemplateService>
-  ) {
-    this.apiService = new ApiDocumentationTemplateService(...args);
-  }
-
-  /**
-   * Create a new document template
-   * @param data - Template data
-   * @param userId - ID of the user creating the template
-   * @returns The created template
-   */
-  async createTemplate(
-    data: CreateDocumentTemplateData,
-    userId: string
-  ): Promise<DocumentTemplate> {
-    return this.apiService.createTemplate(data, userId);
-  }
-
-  /**
-   * Get a document template by ID
-   * @param templateId - ID of the template to retrieve
-   * @param version - Optional version number to retrieve (defaults to latest version)
-   * @returns The template or null if not found
-   */
-  async getTemplateById(
-    templateId: string,
-    version?: number
-  ): Promise<DocumentTemplate | null> {
-    return this.apiService.getTemplateById(templateId, version);
-  }
-
-  /**
-   * Update an existing document template
-   * @param templateId - ID of the template to update
-   * @param data - Updated template data
-   * @returns The updated template
-   */
-  async updateTemplate(
-    templateId: string,
-    data: UpdateDocumentTemplateData
-  ): Promise<DocumentTemplate> {
-    return this.apiService.updateTemplate(templateId, data);
-  }
-
-  /**
-   * Delete a document template
-   * @param templateId - ID of the template to delete
-   */
-  async deleteTemplate(templateId: string): Promise<void> {
-    return this.apiService.deleteTemplate(templateId);
-  }
-
-  /**
-   * Get all active templates
-   * @param pageSize - Number of templates to retrieve
-   * @param lastDoc - Last document from previous page for pagination
-   * @returns Array of templates and the last document for pagination
-   */
-  async getActiveTemplates(
-    pageSize = 20,
-    lastDoc?: QueryDocumentSnapshot<DocumentTemplate>
-  ): Promise<{
-    templates: DocumentTemplate[];
-    lastDoc: QueryDocumentSnapshot<DocumentTemplate> | null;
-  }> {
-    return this.apiService.getActiveTemplates(pageSize, lastDoc);
-  }
-
-  /**
-   * Get all active templates with optional filters and pagination.
-   * @param options - Options for filtering and pagination.
-   * @returns A promise that resolves to the templates and the last visible document.
-   */
-  async getTemplates(options: {
-    pageSize?: number;
-    lastDoc?: QueryDocumentSnapshot<DocumentTemplate>;
-    isUserForm?: boolean;
-    isRequired?: boolean;
-    sortingOrder?: number;
-  }): Promise<{
-    templates: DocumentTemplate[];
-    lastDoc: QueryDocumentSnapshot<DocumentTemplate> | null;
-  }> {
-    return this.apiService.getTemplates(options);
-  }
-
-  /**
-   * Get the total count of active templates with optional filters.
-   * @param options - Options for filtering.
-   * @returns A promise that resolves to the total count of templates.
-   */
-  async getTemplatesCount(options: {
-    isUserForm?: boolean;
-    isRequired?: boolean;
-    sortingOrder?: number;
-    search?: string;
-  }): Promise<number> {
-    return this.apiService.getTemplatesCount(options);
-  }
-
-  /**
-   * Get all active templates without pagination for filtering purposes.
-   * @returns A promise that resolves to an array of all active templates.
-   */
-  async getAllActiveTemplates(): Promise<DocumentTemplate[]> {
-    return this.apiService.getAllActiveTemplates();
-  }
-
-  /**
-   * Searches for active templates by title.
-   * @param title - The title to search for.
-   * @returns A list of templates that match the search criteria.
-   */
-  async search(title: string): Promise<DocumentTemplate[]> {
-    const { templates } = await this.apiService.getActiveTemplates(1000); // A large number to get all templates
-    return templates.filter((t) =>
-      t.title.toLowerCase().includes(title.toLowerCase())
-    );
-  }
-
-  /**
-   * Get templates by tags
-   * @param tags - Tags to filter by
-   * @param pageSize - Number of templates to retrieve
-   * @param lastDoc - Last document from previous page for pagination
-   * @returns Array of templates and the last document for pagination
-   */
-  async getTemplatesByTags(
-    tags: string[],
-    pageSize = 20,
-    lastDoc?: QueryDocumentSnapshot<DocumentTemplate>
-  ): Promise<{
-    templates: DocumentTemplate[];
-    lastDoc: QueryDocumentSnapshot<DocumentTemplate> | null;
-  }> {
-    return this.apiService.getTemplatesByTags(tags, pageSize, lastDoc);
-  }
-
-  /**
-   * Get templates created by a specific user
-   * @param userId - ID of the user who created the templates
-   * @param pageSize - Number of templates to retrieve
-   * @param lastDoc - Last document from previous page for pagination
-   * @returns Array of templates and the last document for pagination
-   */
-  async getTemplatesByCreator(
-    userId: string,
-    pageSize = 20,
-    lastDoc?: QueryDocumentSnapshot<DocumentTemplate>
-  ): Promise<{
-    templates: DocumentTemplate[];
-    lastDoc: QueryDocumentSnapshot<DocumentTemplate> | null;
-  }> {
-    return this.apiService.getTemplatesByCreator(userId, pageSize, lastDoc);
-  }
-
-  /**
-   * Get a specific version of a template
-   * @param templateId - ID of the template
-   * @param versionNumber - Version number to retrieve
-   * @returns The template version or null if not found
-   */
-  async getTemplateVersion(
-    templateId: string,
-    versionNumber: number
-  ): Promise<DocumentTemplate | null> {
-    return this.apiService.getTemplateVersion(templateId, versionNumber);
-  }
-
-  /**
-   * Get all versions of a template
-   * @param templateId - ID of the template
-   * @returns Array of template versions
-   */
-  async getTemplateVersions(templateId: string): Promise<DocumentTemplate[]> {
-    return this.apiService.getTemplateOldVersions(templateId);
-  }
-}
+import { Auth } from "firebase/auth";
+import { Firestore } from "firebase/firestore";
+import { FirebaseApp } from "firebase/app";
+import { DocumentationTemplateService as ApiDocumentationTemplateService } from "../../services/documentation-templates";
+import {
+  CreateDocumentTemplateData,
+  DocumentTemplate,
+  UpdateDocumentTemplateData,
+} from "../../types/documentation-templates";
+import { QueryDocumentSnapshot } from "firebase/firestore";
+
+/**
+ * Service for managing documentation templates in the backoffice
+ */
+export class DocumentationTemplateServiceBackoffice {
+  private apiService: ApiDocumentationTemplateService;
+
+  /**
+   * Constructor for DocumentationTemplateService
+   * @param db - Firestore instance
+   * @param auth - Firebase Auth instance
+   * @param app - Firebase App instance
+   */
+  constructor(
+    ...args: ConstructorParameters<typeof ApiDocumentationTemplateService>
+  ) {
+    this.apiService = new ApiDocumentationTemplateService(...args);
+  }
+
+  /**
+   * Create a new document template
+   * @param data - Template data
+   * @param userId - ID of the user creating the template
+   * @returns The created template
+   */
+  async createTemplate(
+    data: CreateDocumentTemplateData,
+    userId: string
+  ): Promise<DocumentTemplate> {
+    return this.apiService.createTemplate(data, userId);
+  }
+
+  /**
+   * Get a document template by ID
+   * @param templateId - ID of the template to retrieve
+   * @param version - Optional version number to retrieve (defaults to latest version)
+   * @returns The template or null if not found
+   */
+  async getTemplateById(
+    templateId: string,
+    version?: number
+  ): Promise<DocumentTemplate | null> {
+    return this.apiService.getTemplateById(templateId, version);
+  }
+
+  /**
+   * Update an existing document template
+   * @param templateId - ID of the template to update
+   * @param data - Updated template data
+   * @returns The updated template
+   */
+  async updateTemplate(
+    templateId: string,
+    data: UpdateDocumentTemplateData
+  ): Promise<DocumentTemplate> {
+    return this.apiService.updateTemplate(templateId, data);
+  }
+
+  /**
+   * Delete a document template
+   * @param templateId - ID of the template to delete
+   */
+  async deleteTemplate(templateId: string): Promise<void> {
+    return this.apiService.deleteTemplate(templateId);
+  }
+
+  /**
+   * Get all active templates
+   * @param pageSize - Number of templates to retrieve
+   * @param lastDoc - Last document from previous page for pagination
+   * @returns Array of templates and the last document for pagination
+   */
+  async getActiveTemplates(
+    pageSize = 20,
+    lastDoc?: QueryDocumentSnapshot<DocumentTemplate>
+  ): Promise<{
+    templates: DocumentTemplate[];
+    lastDoc: QueryDocumentSnapshot<DocumentTemplate> | null;
+  }> {
+    return this.apiService.getActiveTemplates(pageSize, lastDoc);
+  }
+
+  /**
+   * Get all active templates with optional filters and pagination.
+   * @param options - Options for filtering and pagination.
+   * @returns A promise that resolves to the templates and the last visible document.
+   */
+  async getTemplates(options: {
+    pageSize?: number;
+    lastDoc?: QueryDocumentSnapshot<DocumentTemplate>;
+    isUserForm?: boolean;
+    isRequired?: boolean;
+    sortingOrder?: number;
+  }): Promise<{
+    templates: DocumentTemplate[];
+    lastDoc: QueryDocumentSnapshot<DocumentTemplate> | null;
+  }> {
+    return this.apiService.getTemplates(options);
+  }
+
+  /**
+   * Get the total count of active templates with optional filters.
+   * @param options - Options for filtering.
+   * @returns A promise that resolves to the total count of templates.
+   */
+  async getTemplatesCount(options: {
+    isUserForm?: boolean;
+    isRequired?: boolean;
+    sortingOrder?: number;
+    search?: string;
+  }): Promise<number> {
+    return this.apiService.getTemplatesCount(options);
+  }
+
+  /**
+   * Get all active templates without pagination for filtering purposes.
+   * @returns A promise that resolves to an array of all active templates.
+   */
+  async getAllActiveTemplates(): Promise<DocumentTemplate[]> {
+    return this.apiService.getAllActiveTemplates();
+  }
+
+  /**
+   * Searches for active templates by title.
+   * @param title - The title to search for.
+   * @returns A list of templates that match the search criteria.
+   */
+  async search(title: string): Promise<DocumentTemplate[]> {
+    const { templates } = await this.apiService.getActiveTemplates(1000); // A large number to get all templates
+    return templates.filter((t) =>
+      t.title.toLowerCase().includes(title.toLowerCase())
+    );
+  }
+
+  /**
+   * Get templates by tags
+   * @param tags - Tags to filter by
+   * @param pageSize - Number of templates to retrieve
+   * @param lastDoc - Last document from previous page for pagination
+   * @returns Array of templates and the last document for pagination
+   */
+  async getTemplatesByTags(
+    tags: string[],
+    pageSize = 20,
+    lastDoc?: QueryDocumentSnapshot<DocumentTemplate>
+  ): Promise<{
+    templates: DocumentTemplate[];
+    lastDoc: QueryDocumentSnapshot<DocumentTemplate> | null;
+  }> {
+    return this.apiService.getTemplatesByTags(tags, pageSize, lastDoc);
+  }
+
+  /**
+   * Get templates created by a specific user
+   * @param userId - ID of the user who created the templates
+   * @param pageSize - Number of templates to retrieve
+   * @param lastDoc - Last document from previous page for pagination
+   * @returns Array of templates and the last document for pagination
+   */
+  async getTemplatesByCreator(
+    userId: string,
+    pageSize = 20,
+    lastDoc?: QueryDocumentSnapshot<DocumentTemplate>
+  ): Promise<{
+    templates: DocumentTemplate[];
+    lastDoc: QueryDocumentSnapshot<DocumentTemplate> | null;
+  }> {
+    return this.apiService.getTemplatesByCreator(userId, pageSize, lastDoc);
+  }
+
+  /**
+   * Get a specific version of a template
+   * @param templateId - ID of the template
+   * @param versionNumber - Version number to retrieve
+   * @returns The template version or null if not found
+   */
+  async getTemplateVersion(
+    templateId: string,
+    versionNumber: number
+  ): Promise<DocumentTemplate | null> {
+    return this.apiService.getTemplateVersion(templateId, versionNumber);
+  }
+
+  /**
+   * Get all versions of a template
+   * @param templateId - ID of the template
+   * @returns Array of template versions
+   */
+  async getTemplateVersions(templateId: string): Promise<DocumentTemplate[]> {
+    return this.apiService.getTemplateOldVersions(templateId);
+  }
+}

package/src/backoffice/services/index.ts

@@ -1,11 +1,11 @@
-export * from "./brand.service";
-export * from "./category.service";
-export * from "./documentation-template.service";
-export * from "./product.service";
-export * from "./requirement.service";
-export * from "./subcategory.service";
-export * from "./technology.service";
-export * from "./constants.service";
-
-// Re-export MediaService from main services for backoffice use
+export * from "./brand.service";
+export * from "./category.service";
+export * from "./documentation-template.service";
+export * from "./product.service";
+export * from "./requirement.service";
+export * from "./subcategory.service";
+export * from "./technology.service";
+export * from "./constants.service";
+
+// Re-export MediaService from main services for backoffice use
 export { MediaService, MediaAccessLevel, type MediaMetadata, type MediaResource } from "../../services/media/media.service";

package/src/backoffice/services/migrate-products.ts

@@ -1,116 +1,116 @@
-import * as admin from 'firebase-admin';
-import { Product } from '../types/product.types';
-
-/**
- * Migration script to copy existing products from technology subcollections
- * to the new top-level products collection
- * 
- * Usage: Run this once to migrate existing data
- */
-export async function migrateProductsToTopLevel(db: admin.firestore.Firestore) {
-  console.log('🚀 Starting product migration...');
-  
-  // Get all technologies
-  const technologiesSnapshot = await db.collection('technologies').get();
-  
-  const productMap = new Map<string, {
-    product: any;
-    technologyIds: string[];
-  }>();
-  
-  let totalProcessed = 0;
-  
-  // Step 1: Collect all products from all technology subcollections
-  for (const techDoc of technologiesSnapshot.docs) {
-    const technologyId = techDoc.id;
-    console.log(`📦 Processing technology: ${technologyId}`);
-    
-    const productsSnapshot = await db
-      .collection('technologies')
-      .doc(technologyId)
-      .collection('products')
-      .get();
-    
-    for (const productDoc of productsSnapshot.docs) {
-      const productId = productDoc.id;
-      const productData = productDoc.data();
-      
-      totalProcessed++;
-      
-      // Deduplicate by name + brandId
-      const key = `${productData.name}_${productData.brandId}`;
-      
-      if (productMap.has(key)) {
-        // Product already exists, just add this technology
-        productMap.get(key)!.technologyIds.push(technologyId);
-      } else {
-        // New product
-        productMap.set(key, {
-          product: productData,
-          technologyIds: [technologyId],
-        });
-      }
-    }
-  }
-  
-  console.log(`✅ Found ${productMap.size} unique products from ${totalProcessed} total entries`);
-  
-  // Step 2: Create products in top-level collection
-  const batch = db.batch();
-  let batchCount = 0;
-  const MAX_BATCH_SIZE = 500;
-  let createdCount = 0;
-  
-  for (const [key, { product, technologyIds }] of productMap.entries()) {
-    const productRef = db.collection('products').doc();
-    
-    const migratedProduct: any = {
-      ...product,
-      assignedTechnologyIds: technologyIds, // Track all assigned technologies
-      migratedAt: admin.firestore.FieldValue.serverTimestamp(),
-      migrationKey: key, // For debugging
-    };
-    
-    batch.set(productRef, migratedProduct);
-    createdCount++;
-    batchCount++;
-    
-    if (batchCount >= MAX_BATCH_SIZE) {
-      await batch.commit();
-      console.log(`💾 Committed batch of ${batchCount} products (${createdCount}/${productMap.size})`);
-      batchCount = 0;
-    }
-  }
-  
-  if (batchCount > 0) {
-    await batch.commit();
-    console.log(`💾 Committed final batch of ${batchCount} products`);
-  }
-  
-  console.log('✅ Migration complete!');
-  console.log(`📊 Summary:`);
-  console.log(`   - Products processed: ${totalProcessed}`);
-  console.log(`   - Unique products created: ${createdCount}`);
-  console.log(`   - Average technologies per product: ${(createdCount > 0 ? totalProcessed / createdCount : 0).toFixed(2)}`);
-  
-  return {
-    totalProcessed,
-    uniqueCreated: createdCount,
-  };
-}
-
-/**
- * Run migration (for testing)
- */
-if (require.main === module) {
-  (async () => {
-    try {
-      await migrateProductsToTopLevel(admin.firestore());
-      process.exit(0);
-    } catch (error) {
-      console.error('❌ Migration failed:', error);
-      process.exit(1);
-    }
-  })();
-}
-
+import * as admin from 'firebase-admin';
+import { Product } from '../types/product.types';
+
+/**
+ * Migration script to copy existing products from technology subcollections
+ * to the new top-level products collection
+ * 
+ * Usage: Run this once to migrate existing data
+ */
+export async function migrateProductsToTopLevel(db: admin.firestore.Firestore) {
+  console.log('🚀 Starting product migration...');
+  
+  // Get all technologies
+  const technologiesSnapshot = await db.collection('technologies').get();
+  
+  const productMap = new Map<string, {
+    product: any;
+    technologyIds: string[];
+  }>();
+  
+  let totalProcessed = 0;
+  
+  // Step 1: Collect all products from all technology subcollections
+  for (const techDoc of technologiesSnapshot.docs) {
+    const technologyId = techDoc.id;
+    console.log(`📦 Processing technology: ${technologyId}`);
+    
+    const productsSnapshot = await db
+      .collection('technologies')
+      .doc(technologyId)
+      .collection('products')
+      .get();
+    
+    for (const productDoc of productsSnapshot.docs) {
+      const productId = productDoc.id;
+      const productData = productDoc.data();
+      
+      totalProcessed++;
+      
+      // Deduplicate by name + brandId
+      const key = `${productData.name}_${productData.brandId}`;
+      
+      if (productMap.has(key)) {
+        // Product already exists, just add this technology
+        productMap.get(key)!.technologyIds.push(technologyId);
+      } else {
+        // New product
+        productMap.set(key, {
+          product: productData,
+          technologyIds: [technologyId],
+        });
+      }
+    }
+  }
+  
+  console.log(`✅ Found ${productMap.size} unique products from ${totalProcessed} total entries`);
+  
+  // Step 2: Create products in top-level collection
+  const batch = db.batch();
+  let batchCount = 0;
+  const MAX_BATCH_SIZE = 500;
+  let createdCount = 0;
+  
+  for (const [key, { product, technologyIds }] of productMap.entries()) {
+    const productRef = db.collection('products').doc();
+    
+    const migratedProduct: any = {
+      ...product,
+      assignedTechnologyIds: technologyIds, // Track all assigned technologies
+      migratedAt: admin.firestore.FieldValue.serverTimestamp(),
+      migrationKey: key, // For debugging
+    };
+    
+    batch.set(productRef, migratedProduct);
+    createdCount++;
+    batchCount++;
+    
+    if (batchCount >= MAX_BATCH_SIZE) {
+      await batch.commit();
+      console.log(`💾 Committed batch of ${batchCount} products (${createdCount}/${productMap.size})`);
+      batchCount = 0;
+    }
+  }
+  
+  if (batchCount > 0) {
+    await batch.commit();
+    console.log(`💾 Committed final batch of ${batchCount} products`);
+  }
+  
+  console.log('✅ Migration complete!');
+  console.log(`📊 Summary:`);
+  console.log(`   - Products processed: ${totalProcessed}`);
+  console.log(`   - Unique products created: ${createdCount}`);
+  console.log(`   - Average technologies per product: ${(createdCount > 0 ? totalProcessed / createdCount : 0).toFixed(2)}`);
+  
+  return {
+    totalProcessed,
+    uniqueCreated: createdCount,
+  };
+}
+
+/**
+ * Run migration (for testing)
+ */
+if (require.main === module) {
+  (async () => {
+    try {
+      await migrateProductsToTopLevel(admin.firestore());
+      process.exit(0);
+    } catch (error) {
+      console.error('❌ Migration failed:', error);
+      process.exit(1);
+    }
+  })();
+}
+