@blackcode_sa/metaestetics-api 1.12.67 → 1.12.69

package/dist/admin/index.d.mts

@@ -2053,6 +2053,7 @@ declare enum NotificationType {
     FORM_REMINDER = "formReminder",// Reminds user to fill a specific form
     FORM_SUBMISSION_CONFIRMATION = "formSubmissionConfirmation",// Confirms form was submitted
     REVIEW_REQUEST = "reviewRequest",// Request for patient review post-appointment
+    PROCEDURE_RECOMMENDATION = "procedureRecommendation",// Doctor recommended a procedure for follow-up
     PAYMENT_DUE = "paymentDue",
     PAYMENT_CONFIRMATION = "paymentConfirmation",
     PAYMENT_FAILED = "paymentFailed",
@@ -2222,6 +2223,24 @@ interface ReviewRequestNotification extends BaseNotification {
     practitionerName?: string;
     procedureName?: string;
 }
+/**
+ * Notification for when a doctor recommends a procedure for follow-up.
+ * Example: "Dr. Smith recommended [Procedure Name] for you. Suggested timeframe: in 2 weeks"
+ */
+interface ProcedureRecommendationNotification extends BaseNotification {
+    notificationType: NotificationType.PROCEDURE_RECOMMENDATION;
+    appointmentId: string;
+    recommendationId: string;
+    procedureId: string;
+    procedureName: string;
+    practitionerName: string;
+    clinicName: string;
+    note?: string;
+    timeframe: {
+        value: number;
+        unit: 'day' | 'week' | 'month' | 'year';
+    };
+}
 /**
  * Generic notification for direct messages or announcements.
  */
@@ -2237,7 +2256,7 @@ interface PaymentConfirmationNotification extends BaseNotification {
 /**
  * Unija svih tipova notifikacija
  */
-type Notification = PreRequirementNotification | PostRequirementNotification | RequirementInstructionDueNotification | AppointmentReminderNotification | AppointmentStatusChangeNotification | AppointmentRescheduledProposalNotification | AppointmentCancelledNotification | FormReminderNotification | FormSubmissionConfirmationNotification | ReviewRequestNotification | GeneralMessageNotification | PaymentConfirmationNotification;
+type Notification = PreRequirementNotification | PostRequirementNotification | RequirementInstructionDueNotification | AppointmentReminderNotification | AppointmentStatusChangeNotification | AppointmentRescheduledProposalNotification | AppointmentCancelledNotification | FormReminderNotification | FormSubmissionConfirmationNotification | ReviewRequestNotification | ProcedureRecommendationNotification | GeneralMessageNotification | PaymentConfirmationNotification;
 
 /**
  * Minimal interface for the new mailgun.js client's messages API
@@ -2676,6 +2695,20 @@ declare class AppointmentAggregationService {
      * @param after - The appointment state after update
      */
     private handleZonePhotosUpdate;
+    /**
+     * Checks if recommended procedures have changed between two appointment states
+     * @param before - The appointment state before update
+     * @param after - The appointment state after update
+     * @returns True if recommendations have changed, false otherwise
+     */
+    private hasRecommendationsChanged;
+    /**
+     * Handles recommended procedures update - creates notifications for newly added recommendations
+     * @param before - The appointment state before update
+     * @param after - The appointment state after update
+     * @param patientProfile - The patient profile (for expo tokens)
+     */
+    private handleRecommendedProceduresUpdate;
 }
 
 /**

package/dist/admin/index.d.ts

@@ -2053,6 +2053,7 @@ declare enum NotificationType {
     FORM_REMINDER = "formReminder",// Reminds user to fill a specific form
     FORM_SUBMISSION_CONFIRMATION = "formSubmissionConfirmation",// Confirms form was submitted
     REVIEW_REQUEST = "reviewRequest",// Request for patient review post-appointment
+    PROCEDURE_RECOMMENDATION = "procedureRecommendation",// Doctor recommended a procedure for follow-up
     PAYMENT_DUE = "paymentDue",
     PAYMENT_CONFIRMATION = "paymentConfirmation",
     PAYMENT_FAILED = "paymentFailed",
@@ -2222,6 +2223,24 @@ interface ReviewRequestNotification extends BaseNotification {
     practitionerName?: string;
     procedureName?: string;
 }
+/**
+ * Notification for when a doctor recommends a procedure for follow-up.
+ * Example: "Dr. Smith recommended [Procedure Name] for you. Suggested timeframe: in 2 weeks"
+ */
+interface ProcedureRecommendationNotification extends BaseNotification {
+    notificationType: NotificationType.PROCEDURE_RECOMMENDATION;
+    appointmentId: string;
+    recommendationId: string;
+    procedureId: string;
+    procedureName: string;
+    practitionerName: string;
+    clinicName: string;
+    note?: string;
+    timeframe: {
+        value: number;
+        unit: 'day' | 'week' | 'month' | 'year';
+    };
+}
 /**
  * Generic notification for direct messages or announcements.
  */
@@ -2237,7 +2256,7 @@ interface PaymentConfirmationNotification extends BaseNotification {
 /**
  * Unija svih tipova notifikacija
  */
-type Notification = PreRequirementNotification | PostRequirementNotification | RequirementInstructionDueNotification | AppointmentReminderNotification | AppointmentStatusChangeNotification | AppointmentRescheduledProposalNotification | AppointmentCancelledNotification | FormReminderNotification | FormSubmissionConfirmationNotification | ReviewRequestNotification | GeneralMessageNotification | PaymentConfirmationNotification;
+type Notification = PreRequirementNotification | PostRequirementNotification | RequirementInstructionDueNotification | AppointmentReminderNotification | AppointmentStatusChangeNotification | AppointmentRescheduledProposalNotification | AppointmentCancelledNotification | FormReminderNotification | FormSubmissionConfirmationNotification | ReviewRequestNotification | ProcedureRecommendationNotification | GeneralMessageNotification | PaymentConfirmationNotification;
 
 /**
  * Minimal interface for the new mailgun.js client's messages API
@@ -2676,6 +2695,20 @@ declare class AppointmentAggregationService {
      * @param after - The appointment state after update
      */
     private handleZonePhotosUpdate;
+    /**
+     * Checks if recommended procedures have changed between two appointment states
+     * @param before - The appointment state before update
+     * @param after - The appointment state after update
+     * @returns True if recommendations have changed, false otherwise
+     */
+    private hasRecommendationsChanged;
+    /**
+     * Handles recommended procedures update - creates notifications for newly added recommendations
+     * @param before - The appointment state before update
+     * @param after - The appointment state after update
+     * @param patientProfile - The patient profile (for expo tokens)
+     */
+    private handleRecommendedProceduresUpdate;
 }
 
 /**

package/dist/admin/index.js

@@ -489,6 +489,7 @@ var NotificationType = /* @__PURE__ */ ((NotificationType2) => {
   NotificationType2["FORM_REMINDER"] = "formReminder";
   NotificationType2["FORM_SUBMISSION_CONFIRMATION"] = "formSubmissionConfirmation";
   NotificationType2["REVIEW_REQUEST"] = "reviewRequest";
+  NotificationType2["PROCEDURE_RECOMMENDATION"] = "procedureRecommendation";
   NotificationType2["PAYMENT_DUE"] = "paymentDue";
   NotificationType2["PAYMENT_CONFIRMATION"] = "paymentConfirmation";
   NotificationType2["PAYMENT_FAILED"] = "paymentFailed";
@@ -2928,6 +2929,11 @@ var AppointmentAggregationService = class {
         Logger.info(`[AggService] Zone photos changed for appointment ${after.id}`);
         await this.handleZonePhotosUpdate(before, after);
       }
+      const recommendationsChanged = this.hasRecommendationsChanged(before, after);
+      if (recommendationsChanged) {
+        Logger.info(`[AggService] Recommended procedures changed for appointment ${after.id}`);
+        await this.handleRecommendedProceduresUpdate(before, after, patientProfile);
+      }
       Logger.info(`[AggService] Successfully processed UPDATE for appointment: ${after.id}`);
     } catch (error) {
       Logger.error(
@@ -3960,6 +3966,104 @@ var AppointmentAggregationService = class {
       );
     }
   }
+  /**
+   * Checks if recommended procedures have changed between two appointment states
+   * @param before - The appointment state before update
+   * @param after - The appointment state after update
+   * @returns True if recommendations have changed, false otherwise
+   */
+  hasRecommendationsChanged(before, after) {
+    var _a, _b;
+    const beforeRecommendations = ((_a = before.metadata) == null ? void 0 : _a.recommendedProcedures) || [];
+    const afterRecommendations = ((_b = after.metadata) == null ? void 0 : _b.recommendedProcedures) || [];
+    if (beforeRecommendations.length !== afterRecommendations.length) {
+      return true;
+    }
+    for (let i = 0; i < afterRecommendations.length; i++) {
+      const beforeRec = beforeRecommendations[i];
+      const afterRec = afterRecommendations[i];
+      if (!beforeRec || !afterRec) {
+        return true;
+      }
+      if (beforeRec.procedure.procedureId !== afterRec.procedure.procedureId || beforeRec.note !== afterRec.note || beforeRec.timeframe.value !== afterRec.timeframe.value || beforeRec.timeframe.unit !== afterRec.timeframe.unit) {
+        return true;
+      }
+    }
+    return false;
+  }
+  /**
+   * Handles recommended procedures update - creates notifications for newly added recommendations
+   * @param before - The appointment state before update
+   * @param after - The appointment state after update
+   * @param patientProfile - The patient profile (for expo tokens)
+   */
+  async handleRecommendedProceduresUpdate(before, after, patientProfile) {
+    var _a, _b, _c, _d, _e;
+    try {
+      const beforeRecommendations = ((_a = before.metadata) == null ? void 0 : _a.recommendedProcedures) || [];
+      const afterRecommendations = ((_b = after.metadata) == null ? void 0 : _b.recommendedProcedures) || [];
+      const newRecommendations = afterRecommendations.slice(beforeRecommendations.length);
+      if (newRecommendations.length === 0) {
+        Logger.info(
+          `[AggService] No new recommendations detected for appointment ${after.id}`
+        );
+        return;
+      }
+      Logger.info(
+        `[AggService] Found ${newRecommendations.length} new recommendation(s) for appointment ${after.id}`
+      );
+      for (let i = 0; i < newRecommendations.length; i++) {
+        const recommendation = newRecommendations[i];
+        const recommendationIndex = beforeRecommendations.length + i;
+        const recommendationId = `${after.id}:${recommendationIndex}`;
+        const timeframeText = `${recommendation.timeframe.value} ${recommendation.timeframe.unit}${recommendation.timeframe.value > 1 ? "s" : ""}`;
+        const notificationPayload = {
+          userId: after.patientId,
+          userRole: "patient" /* PATIENT */,
+          notificationType: "procedureRecommendation" /* PROCEDURE_RECOMMENDATION */,
+          notificationTime: admin6.firestore.Timestamp.now(),
+          notificationTokens: (patientProfile == null ? void 0 : patientProfile.expoTokens) || [],
+          title: "New Procedure Recommendation",
+          body: `${((_c = after.practitionerInfo) == null ? void 0 : _c.name) || "Your doctor"} recommended "${recommendation.procedure.procedureName}" for you. Suggested timeframe: in ${timeframeText}`,
+          appointmentId: after.id,
+          recommendationId,
+          procedureId: recommendation.procedure.procedureId,
+          procedureName: recommendation.procedure.procedureName,
+          practitionerName: ((_d = after.practitionerInfo) == null ? void 0 : _d.name) || "Unknown Practitioner",
+          clinicName: ((_e = after.clinicInfo) == null ? void 0 : _e.name) || "Unknown Clinic",
+          note: recommendation.note,
+          timeframe: recommendation.timeframe
+        };
+        try {
+          const notificationId = await this.notificationsAdmin.createNotification(
+            notificationPayload
+          );
+          Logger.info(
+            `[AggService] Created notification ${notificationId} for recommendation ${recommendationId}`
+          );
+          if ((patientProfile == null ? void 0 : patientProfile.expoTokens) && patientProfile.expoTokens.length > 0) {
+            const notification = await this.notificationsAdmin.getNotification(notificationId);
+            if (notification) {
+              await this.notificationsAdmin.sendPushNotification(notification);
+              Logger.info(
+                `[AggService] Sent push notification for recommendation ${recommendationId}`
+              );
+            }
+          }
+        } catch (error) {
+          Logger.error(
+            `[AggService] Error creating notification for recommendation ${recommendationId}:`,
+            error
+          );
+        }
+      }
+    } catch (error) {
+      Logger.error(
+        `[AggService] Error handling recommended procedures update for appointment ${after.id}:`,
+        error
+      );
+    }
+  }
 };
 
 // src/admin/aggregation/clinic/clinic.aggregation.service.ts

package/dist/admin/index.mjs

@@ -427,6 +427,7 @@ var NotificationType = /* @__PURE__ */ ((NotificationType2) => {
   NotificationType2["FORM_REMINDER"] = "formReminder";
   NotificationType2["FORM_SUBMISSION_CONFIRMATION"] = "formSubmissionConfirmation";
   NotificationType2["REVIEW_REQUEST"] = "reviewRequest";
+  NotificationType2["PROCEDURE_RECOMMENDATION"] = "procedureRecommendation";
   NotificationType2["PAYMENT_DUE"] = "paymentDue";
   NotificationType2["PAYMENT_CONFIRMATION"] = "paymentConfirmation";
   NotificationType2["PAYMENT_FAILED"] = "paymentFailed";
@@ -2866,6 +2867,11 @@ var AppointmentAggregationService = class {
         Logger.info(`[AggService] Zone photos changed for appointment ${after.id}`);
         await this.handleZonePhotosUpdate(before, after);
       }
+      const recommendationsChanged = this.hasRecommendationsChanged(before, after);
+      if (recommendationsChanged) {
+        Logger.info(`[AggService] Recommended procedures changed for appointment ${after.id}`);
+        await this.handleRecommendedProceduresUpdate(before, after, patientProfile);
+      }
       Logger.info(`[AggService] Successfully processed UPDATE for appointment: ${after.id}`);
     } catch (error) {
       Logger.error(
@@ -3898,6 +3904,104 @@ var AppointmentAggregationService = class {
       );
     }
   }
+  /**
+   * Checks if recommended procedures have changed between two appointment states
+   * @param before - The appointment state before update
+   * @param after - The appointment state after update
+   * @returns True if recommendations have changed, false otherwise
+   */
+  hasRecommendationsChanged(before, after) {
+    var _a, _b;
+    const beforeRecommendations = ((_a = before.metadata) == null ? void 0 : _a.recommendedProcedures) || [];
+    const afterRecommendations = ((_b = after.metadata) == null ? void 0 : _b.recommendedProcedures) || [];
+    if (beforeRecommendations.length !== afterRecommendations.length) {
+      return true;
+    }
+    for (let i = 0; i < afterRecommendations.length; i++) {
+      const beforeRec = beforeRecommendations[i];
+      const afterRec = afterRecommendations[i];
+      if (!beforeRec || !afterRec) {
+        return true;
+      }
+      if (beforeRec.procedure.procedureId !== afterRec.procedure.procedureId || beforeRec.note !== afterRec.note || beforeRec.timeframe.value !== afterRec.timeframe.value || beforeRec.timeframe.unit !== afterRec.timeframe.unit) {
+        return true;
+      }
+    }
+    return false;
+  }
+  /**
+   * Handles recommended procedures update - creates notifications for newly added recommendations
+   * @param before - The appointment state before update
+   * @param after - The appointment state after update
+   * @param patientProfile - The patient profile (for expo tokens)
+   */
+  async handleRecommendedProceduresUpdate(before, after, patientProfile) {
+    var _a, _b, _c, _d, _e;
+    try {
+      const beforeRecommendations = ((_a = before.metadata) == null ? void 0 : _a.recommendedProcedures) || [];
+      const afterRecommendations = ((_b = after.metadata) == null ? void 0 : _b.recommendedProcedures) || [];
+      const newRecommendations = afterRecommendations.slice(beforeRecommendations.length);
+      if (newRecommendations.length === 0) {
+        Logger.info(
+          `[AggService] No new recommendations detected for appointment ${after.id}`
+        );
+        return;
+      }
+      Logger.info(
+        `[AggService] Found ${newRecommendations.length} new recommendation(s) for appointment ${after.id}`
+      );
+      for (let i = 0; i < newRecommendations.length; i++) {
+        const recommendation = newRecommendations[i];
+        const recommendationIndex = beforeRecommendations.length + i;
+        const recommendationId = `${after.id}:${recommendationIndex}`;
+        const timeframeText = `${recommendation.timeframe.value} ${recommendation.timeframe.unit}${recommendation.timeframe.value > 1 ? "s" : ""}`;
+        const notificationPayload = {
+          userId: after.patientId,
+          userRole: "patient" /* PATIENT */,
+          notificationType: "procedureRecommendation" /* PROCEDURE_RECOMMENDATION */,
+          notificationTime: admin6.firestore.Timestamp.now(),
+          notificationTokens: (patientProfile == null ? void 0 : patientProfile.expoTokens) || [],
+          title: "New Procedure Recommendation",
+          body: `${((_c = after.practitionerInfo) == null ? void 0 : _c.name) || "Your doctor"} recommended "${recommendation.procedure.procedureName}" for you. Suggested timeframe: in ${timeframeText}`,
+          appointmentId: after.id,
+          recommendationId,
+          procedureId: recommendation.procedure.procedureId,
+          procedureName: recommendation.procedure.procedureName,
+          practitionerName: ((_d = after.practitionerInfo) == null ? void 0 : _d.name) || "Unknown Practitioner",
+          clinicName: ((_e = after.clinicInfo) == null ? void 0 : _e.name) || "Unknown Clinic",
+          note: recommendation.note,
+          timeframe: recommendation.timeframe
+        };
+        try {
+          const notificationId = await this.notificationsAdmin.createNotification(
+            notificationPayload
+          );
+          Logger.info(
+            `[AggService] Created notification ${notificationId} for recommendation ${recommendationId}`
+          );
+          if ((patientProfile == null ? void 0 : patientProfile.expoTokens) && patientProfile.expoTokens.length > 0) {
+            const notification = await this.notificationsAdmin.getNotification(notificationId);
+            if (notification) {
+              await this.notificationsAdmin.sendPushNotification(notification);
+              Logger.info(
+                `[AggService] Sent push notification for recommendation ${recommendationId}`
+              );
+            }
+          }
+        } catch (error) {
+          Logger.error(
+            `[AggService] Error creating notification for recommendation ${recommendationId}:`,
+            error
+          );
+        }
+      }
+    } catch (error) {
+      Logger.error(
+        `[AggService] Error handling recommended procedures update for appointment ${after.id}:`,
+        error
+      );
+    }
+  }
 };
 
 // src/admin/aggregation/clinic/clinic.aggregation.service.ts

package/dist/backoffice/index.d.mts

@@ -209,6 +209,12 @@ interface ICategoryService {
  * });
  */
 declare class CategoryService extends BaseService implements ICategoryService {
+    /**
+     * Filters out excluded categories from a list.
+     * @param categories - List of categories to filter
+     * @returns Filtered list without excluded categories
+     */
+    private filterExcludedCategories;
     /**
      * Referenca na Firestore kolekciju kategorija
      */
@@ -294,6 +300,13 @@ declare class CategoryService extends BaseService implements ICategoryService {
      * @returns Kategorija ili null ako ne postoji
      */
     getById(id: string): Promise<Category | null>;
+    /**
+     * Internal method to get category by ID without filtering.
+     * Used internally for consultation procedures.
+     * @param id - ID of the category to get
+     * @returns Category or null if not found
+     */
+    getByIdInternal(id: string): Promise<Category | null>;
     /**
      * Finds a category by exact name match within a specific family.
      * Used for CSV import matching.
@@ -1900,6 +1913,12 @@ declare class RequirementService extends BaseService {
  * });
  */
 declare class SubcategoryService extends BaseService {
+    /**
+     * Filters out excluded subcategories from a list.
+     * @param subcategories - List of subcategories to filter
+     * @returns Filtered list without excluded subcategories
+     */
+    private filterExcludedSubcategories;
     /**
      * Vraća referencu na Firestore kolekciju podkategorija za određenu kategoriju
      * @param categoryId - ID roditeljske kategorije
@@ -1994,6 +2013,14 @@ declare class SubcategoryService extends BaseService {
      * @returns Podkategorija ili null ako ne postoji
      */
     getById(categoryId: string, subcategoryId: string): Promise<Subcategory | null>;
+    /**
+     * Internal method to get subcategory by ID without filtering.
+     * Used internally for consultation procedures.
+     * @param categoryId - ID of the category
+     * @param subcategoryId - ID of the subcategory to get
+     * @returns Subcategory or null if not found
+     */
+    getByIdInternal(categoryId: string, subcategoryId: string): Promise<Subcategory | null>;
     /**
      * Finds a subcategory by exact name match within a specific category.
      * Used for CSV import matching.
@@ -2020,6 +2047,12 @@ declare class SubcategoryService extends BaseService {
  * Service for managing technologies.
  */
 declare class TechnologyService extends BaseService implements ITechnologyService {
+    /**
+     * Filters out excluded technologies from a list.
+     * @param technologies - List of technologies to filter
+     * @returns Filtered list without excluded technologies
+     */
+    private filterExcludedTechnologies;
     /**
      * Reference to the Firestore collection of technologies.
      */
@@ -2127,6 +2160,13 @@ declare class TechnologyService extends BaseService implements ITechnologyServic
      * @returns The technology or null if it doesn't exist.
      */
     getById(id: string): Promise<Technology | null>;
+    /**
+     * Internal method to get technology by ID without filtering.
+     * Used internally for consultation procedures.
+     * @param id - The ID of the requested technology
+     * @returns The technology or null if it doesn't exist
+     */
+    getByIdInternal(id: string): Promise<Technology | null>;
     /**
      * Finds a technology by exact name match.
      * Used for CSV import duplicate detection.

package/dist/backoffice/index.d.ts

@@ -209,6 +209,12 @@ interface ICategoryService {
  * });
  */
 declare class CategoryService extends BaseService implements ICategoryService {
+    /**
+     * Filters out excluded categories from a list.
+     * @param categories - List of categories to filter
+     * @returns Filtered list without excluded categories
+     */
+    private filterExcludedCategories;
     /**
      * Referenca na Firestore kolekciju kategorija
      */
@@ -294,6 +300,13 @@ declare class CategoryService extends BaseService implements ICategoryService {
      * @returns Kategorija ili null ako ne postoji
      */
     getById(id: string): Promise<Category | null>;
+    /**
+     * Internal method to get category by ID without filtering.
+     * Used internally for consultation procedures.
+     * @param id - ID of the category to get
+     * @returns Category or null if not found
+     */
+    getByIdInternal(id: string): Promise<Category | null>;
     /**
      * Finds a category by exact name match within a specific family.
      * Used for CSV import matching.
@@ -1900,6 +1913,12 @@ declare class RequirementService extends BaseService {
  * });
  */
 declare class SubcategoryService extends BaseService {
+    /**
+     * Filters out excluded subcategories from a list.
+     * @param subcategories - List of subcategories to filter
+     * @returns Filtered list without excluded subcategories
+     */
+    private filterExcludedSubcategories;
     /**
      * Vraća referencu na Firestore kolekciju podkategorija za određenu kategoriju
      * @param categoryId - ID roditeljske kategorije
@@ -1994,6 +2013,14 @@ declare class SubcategoryService extends BaseService {
      * @returns Podkategorija ili null ako ne postoji
      */
     getById(categoryId: string, subcategoryId: string): Promise<Subcategory | null>;
+    /**
+     * Internal method to get subcategory by ID without filtering.
+     * Used internally for consultation procedures.
+     * @param categoryId - ID of the category
+     * @param subcategoryId - ID of the subcategory to get
+     * @returns Subcategory or null if not found
+     */
+    getByIdInternal(categoryId: string, subcategoryId: string): Promise<Subcategory | null>;
     /**
      * Finds a subcategory by exact name match within a specific category.
      * Used for CSV import matching.
@@ -2020,6 +2047,12 @@ declare class SubcategoryService extends BaseService {
  * Service for managing technologies.
  */
 declare class TechnologyService extends BaseService implements ITechnologyService {
+    /**
+     * Filters out excluded technologies from a list.
+     * @param technologies - List of technologies to filter
+     * @returns Filtered list without excluded technologies
+     */
+    private filterExcludedTechnologies;
     /**
      * Reference to the Firestore collection of technologies.
      */
@@ -2127,6 +2160,13 @@ declare class TechnologyService extends BaseService implements ITechnologyServic
      * @returns The technology or null if it doesn't exist.
      */
     getById(id: string): Promise<Technology | null>;
+    /**
+     * Internal method to get technology by ID without filtering.
+     * Used internally for consultation procedures.
+     * @param id - The ID of the requested technology
+     * @returns The technology or null if it doesn't exist
+     */
+    getByIdInternal(id: string): Promise<Technology | null>;
     /**
      * Finds a technology by exact name match.
      * Used for CSV import duplicate detection.