@blackcode_sa/metaestetics-api 1.7.16 → 1.7.17

package/src/services/documentation-templates/filled-document.service.ts

@@ -19,11 +19,17 @@ import {
   // FILLED_DOCUMENTS_COLLECTION, // This will be replaced by subcollection paths
   FilledDocument,
   FilledDocumentStatus,
+  FilledDocumentFileValue,
   USER_FORMS_SUBCOLLECTION,
   DOCTOR_FORMS_SUBCOLLECTION,
 } from "../../types"; // General types
 import { APPOINTMENTS_COLLECTION } from "../../types/appointment"; // Specific import for the constant
 import { DocumentationTemplateService } from "./documentation-template.service";
+import {
+  MediaService,
+  MediaAccessLevel,
+  MediaMetadata,
+} from "../media/media.service";
 // Import the new validation schemas if you plan to use them for input validation here
 // import { createFilledDocumentDataSchema, updateFilledDocumentDataSchema } from '../../validations/documentation-templates.schema';
 
@@ -33,10 +39,12 @@ import { DocumentationTemplateService } from "./documentation-template.service";
 export class FilledDocumentService extends BaseService {
   // No single collectionRef anymore, paths will be dynamic
   private readonly templateService: DocumentationTemplateService;
+  private readonly mediaService: MediaService;
 
   constructor(...args: ConstructorParameters<typeof BaseService>) {
     super(...args);
     this.templateService = new DocumentationTemplateService(...args); // Pass db and other args
+    this.mediaService = new MediaService(...args); // Initialize media service with the same args
   }
 
   private getFormSubcollectionPath(
@@ -468,4 +476,216 @@ export class FilledDocumentService extends BaseService {
     */
     return { documents: [], lastDoc: null }; // Placeholder return
   }
+
+  /**
+   * Upload a file and associate it with a filled document field.
+   * @param appointmentId - ID of the appointment.
+   * @param formId - ID of the filled document.
+   * @param isUserForm - Boolean indicating if it's a user form or doctor form.
+   * @param file - The file to upload.
+   * @param fieldId - The ID of the field in the document to associate with this file.
+   * @param accessLevel - Access level for the file, defaults to PRIVATE.
+   * @returns The updated filled document with file information.
+   */
+  async uploadFileForFilledDocument(
+    appointmentId: string,
+    formId: string,
+    isUserForm: boolean,
+    file: File | Blob,
+    fieldId: string,
+    accessLevel: MediaAccessLevel = MediaAccessLevel.PRIVATE
+  ): Promise<FilledDocument> {
+    console.log(
+      `[FilledDocumentService] Uploading file for field ${fieldId} in form ${formId}`
+    );
+
+    // 1. Get the existing document to verify it exists and to get the patientId
+    const existingDoc = await this.getFilledDocumentFromAppointmentById(
+      appointmentId,
+      formId,
+      isUserForm
+    );
+
+    if (!existingDoc) {
+      throw new Error(
+        `Filled document with ID ${formId} not found in appointment ${appointmentId}`
+      );
+    }
+
+    // 2. Upload the file using MediaService
+    const ownerId = existingDoc.patientId; // Using patientId as ownerId for permissions
+    const collectionName = isUserForm
+      ? "patient_forms_files"
+      : "doctor_forms_files";
+
+    const mediaMetadata = await this.mediaService.uploadMedia(
+      file,
+      ownerId,
+      accessLevel,
+      collectionName,
+      file instanceof File ? file.name : `${fieldId}_file`
+    );
+
+    // 3. Create a file value object to store in the document
+    const fileValue: FilledDocumentFileValue = {
+      mediaId: mediaMetadata.id,
+      url: mediaMetadata.url,
+      name: mediaMetadata.name,
+      contentType: mediaMetadata.contentType,
+      size: mediaMetadata.size,
+      uploadedAt: Date.now(),
+    };
+
+    // 4. Update the document with the file value
+    const values = {
+      [fieldId]: fileValue,
+    };
+
+    // 5. Use the existing update method to save the file reference
+    return this.updateFilledDocumentInAppointment(
+      appointmentId,
+      formId,
+      isUserForm,
+      values
+    );
+  }
+
+  /**
+   * Upload a signature image for a filled document field.
+   * This is a specialized version of uploadFileForFilledDocument specifically for signatures.
+   * @param appointmentId - ID of the appointment.
+   * @param formId - ID of the filled document.
+   * @param isUserForm - Boolean indicating if it's a user form or doctor form.
+   * @param signatureBlob - The signature image as a Blob.
+   * @param fieldId - The ID of the signature field in the document.
+   * @returns The updated filled document with signature information.
+   */
+  async uploadSignatureForFilledDocument(
+    appointmentId: string,
+    formId: string,
+    isUserForm: boolean,
+    signatureBlob: Blob,
+    fieldId: string
+  ): Promise<FilledDocument> {
+    console.log(
+      `[FilledDocumentService] Uploading signature for field ${fieldId} in form ${formId}`
+    );
+
+    // Use the general file upload method, but specify a fixed name and access level for signatures
+    const signatureFile = new File(
+      [signatureBlob],
+      `signature_${fieldId}.png`,
+      {
+        type: "image/png",
+      }
+    );
+
+    return this.uploadFileForFilledDocument(
+      appointmentId,
+      formId,
+      isUserForm,
+      signatureFile,
+      fieldId,
+      MediaAccessLevel.CONFIDENTIAL // Signatures should be confidential
+    );
+  }
+
+  /**
+   * Remove a file from a filled document field.
+   * This will both update the document and delete the media file.
+   * @param appointmentId - ID of the appointment.
+   * @param formId - ID of the filled document.
+   * @param isUserForm - Boolean indicating if it's a user form or doctor form.
+   * @param fieldId - The ID of the field containing the file.
+   * @returns The updated filled document with the file removed.
+   */
+  async removeFileFromFilledDocument(
+    appointmentId: string,
+    formId: string,
+    isUserForm: boolean,
+    fieldId: string
+  ): Promise<FilledDocument> {
+    console.log(
+      `[FilledDocumentService] Removing file from field ${fieldId} in form ${formId}`
+    );
+
+    // 1. Get the existing document to verify it exists and to get the file info
+    const existingDoc = await this.getFilledDocumentFromAppointmentById(
+      appointmentId,
+      formId,
+      isUserForm
+    );
+
+    if (!existingDoc) {
+      throw new Error(
+        `Filled document with ID ${formId} not found in appointment ${appointmentId}`
+      );
+    }
+
+    // 2. Check if the field has a file value
+    const fileValue = existingDoc.values?.[fieldId] as FilledDocumentFileValue;
+    if (fileValue && fileValue.mediaId) {
+      // 3. Delete the file using MediaService
+      try {
+        await this.mediaService.deleteMedia(fileValue.mediaId);
+      } catch (error) {
+        console.error(
+          `[FilledDocumentService] Error deleting media ${fileValue.mediaId}:`,
+          error
+        );
+        // Continue with document update even if media deletion fails
+      }
+    }
+
+    // 4. Update the document to remove the file reference
+    const values = {
+      [fieldId]: null,
+    };
+
+    // 5. Use the existing update method to save the changes
+    return this.updateFilledDocumentInAppointment(
+      appointmentId,
+      formId,
+      isUserForm,
+      values
+    );
+  }
+
+  /**
+   * Get the download URL for a file in a filled document.
+   * @param appointmentId - ID of the appointment.
+   * @param formId - ID of the filled document.
+   * @param isUserForm - Boolean indicating if it's a user form or doctor form.
+   * @param fieldId - The ID of the field containing the file.
+   * @returns The download URL for the file, or null if not found.
+   */
+  async getFileUrlFromFilledDocument(
+    appointmentId: string,
+    formId: string,
+    isUserForm: boolean,
+    fieldId: string
+  ): Promise<string | null> {
+    console.log(
+      `[FilledDocumentService] Getting file URL for field ${fieldId} in form ${formId}`
+    );
+
+    // 1. Get the document
+    const doc = await this.getFilledDocumentFromAppointmentById(
+      appointmentId,
+      formId,
+      isUserForm
+    );
+
+    if (!doc) {
+      return null;
+    }
+
+    // 2. Check if the field has a file value
+    const fileValue = doc.values?.[fieldId] as FilledDocumentFileValue;
+    if (fileValue && fileValue.url) {
+      return fileValue.url;
+    }
+
+    return null;
+  }
 }

package/src/types/documentation-templates/index.ts

@@ -279,7 +279,7 @@ export interface FilledDocument {
   clinicId: string;
   createdAt: number;
   updatedAt: number;
-  values: { [elementId: string]: any }; // Values for each element
+  values: { [elementId: string]: any | FilledDocumentFileValue }; // Values for each element
   status: FilledDocumentStatus;
 }
 
@@ -294,3 +294,15 @@ export enum FilledDocumentStatus {
   SIGNED = "signed", // Only used for user forms
   REJECTED = "rejected", // Only used for user forms
 }
+
+/**
+ * Interface for file upload results to be stored in filled document values
+ */
+export interface FilledDocumentFileValue {
+  mediaId: string;
+  url: string;
+  name: string;
+  contentType: string;
+  size: number;
+  uploadedAt: number;
+}