@blackcode_sa/metaestetics-api 1.6.24 → 1.6.26

package/dist/index.d.ts

@@ -355,265 +355,18 @@ interface CertificationRequirement {
 }
 
 /**
- * Types for the Medical Documentation Templating System
- */
-/**
- * Kolekcija u Firestore bazi gde se čuvaju dokumentacijske šablone
- */
-declare const DOCUMENTATION_TEMPLATES_COLLECTION = "documentation-templates";
-declare const FILLED_DOCUMENTS_COLLECTION = "filled-documents";
-declare const USER_FORMS_SUBCOLLECTION = "user-forms";
-declare const DOCTOR_FORMS_SUBCOLLECTION = "doctor-forms";
-/**
- * Enum for element types in documentation templates
- */
-declare enum DocumentElementType {
-    HEADING = "heading",
-    PARAGRAPH = "paragraph",
-    LIST = "list",
-    DYNAMIC_TEXT = "dynamic_text",
-    BINARY_CHOICE = "binary_choice",
-    MULTIPLE_CHOICE = "multiple_choice",
-    SINGLE_CHOICE = "single_choice",
-    RATING_SCALE = "rating_scale",
-    TEXT_INPUT = "text_input",
-    DATE_PICKER = "date_picker",
-    SIGNATURE = "signature",
-    DITIGAL_SIGNATURE = "digital_signature",
-    FILE_UPLOAD = "file_upload"
-}
-/**
- * Enum for list types
- */
-declare enum ListType {
-    ORDERED = "ordered",
-    UNORDERED = "unordered"
-}
-/**
- * Enum for heading levels
- */
-declare enum HeadingLevel {
-    H1 = "h1",
-    H2 = "h2",
-    H3 = "h3",
-    H4 = "h4",
-    H5 = "h5",
-    H6 = "h6"
-}
-/**
- * Enum for dynamic variable placeholders
- */
-declare enum DynamicVariable {
-    PATIENT_NAME = "$[PATIENT_NAME]",
-    DOCTOR_NAME = "$[DOCTOR_NAME]",
-    CLINIC_NAME = "$[CLINIC_NAME]",
-    PATIENT_BIRTHDAY = "$[PATIENT_BIRTHDAY]",
-    APPOINTMENT_DATE = "$[APPOINTMENT_DATE]",
-    CURRENT_DATE = "$[CURRENT_DATE]",
-    PROCEDURE_NAME = "$[PROCEDURE_NAME]",
-    PROCEDURE_DESCRIPTION = "$[PROCEDURE_DESCRIPTION]",
-    PROCEDURE_COST = "$[PROCEDURE_COST]",
-    PROCEDURE_DURATION = "$[PROCEDURE_DURATION]",
-    PROCEDURE_RISK = "$[PROCEDURE_RISK]"
-}
-/**
- * Base interface for all document elements
- */
-interface BaseDocumentElement {
-    id: string;
-    type: DocumentElementType;
-    required?: boolean;
-}
-/**
- * Interface for heading element
- */
-interface HeadingElement extends BaseDocumentElement {
-    type: DocumentElementType.HEADING;
-    text: string;
-    level: HeadingLevel;
-}
-/**
- * Interface for paragraph element
- */
-interface ParagraphElement extends BaseDocumentElement {
-    type: DocumentElementType.PARAGRAPH;
-    text: string;
-}
-/**
- * Interface for list element
- */
-interface ListElement extends BaseDocumentElement {
-    type: DocumentElementType.LIST;
-    items: string[];
-    listType: ListType;
-}
-/**
- * Interface for dynamic text element
- */
-interface DynamicTextElement extends BaseDocumentElement {
-    type: DocumentElementType.DYNAMIC_TEXT;
-    text: string;
-}
-/**
- * Interface for binary choice element (Yes/No)
- */
-interface BinaryChoiceElement extends BaseDocumentElement {
-    type: DocumentElementType.BINARY_CHOICE;
-    question: string;
-    defaultValue?: boolean;
-}
-/**
- * Interface for multiple choice element
- */
-interface MultipleChoiceElement extends BaseDocumentElement {
-    type: DocumentElementType.MULTIPLE_CHOICE;
-    question: string;
-    options: string[];
-    defaultValues?: string[];
-}
-/**
- * Interface for single choice element
- */
-interface SingleChoiceElement extends BaseDocumentElement {
-    type: DocumentElementType.SINGLE_CHOICE;
-    question: string;
-    options: string[];
-    defaultValue?: string;
-}
-/**
- * Interface for rating scale element
- */
-interface RatingScaleElement extends BaseDocumentElement {
-    type: DocumentElementType.RATING_SCALE;
-    question: string;
-    min: number;
-    max: number;
-    labels?: {
-        [key: number]: string;
-    };
-    defaultValue?: number;
-}
-/**
- * Interface for text input element
- */
-interface TextInputElement extends BaseDocumentElement {
-    type: DocumentElementType.TEXT_INPUT;
-    label: string;
-    placeholder?: string;
-    multiline?: boolean;
-    defaultValue?: string;
-}
-/**
- * Interface for date picker element
- */
-interface DatePickerElement extends BaseDocumentElement {
-    type: DocumentElementType.DATE_PICKER;
-    label: string;
-    defaultValue?: string;
-}
-/**
- * Interface for signature element
- */
-interface SignatureElement extends BaseDocumentElement {
-    type: DocumentElementType.SIGNATURE;
-    label: string;
-}
-/**
- * Interface for digital signature element
- */
-interface DigitalSignatureElement extends BaseDocumentElement {
-    type: DocumentElementType.DITIGAL_SIGNATURE;
-    label: string;
-}
-/**
- * Interface for file upload element
- */
-interface FileUploadElement extends BaseDocumentElement {
-    type: DocumentElementType.FILE_UPLOAD;
-    label: string;
-    allowedFileTypes?: string[];
-    maxFileSizeMB?: number;
-}
-/**
- * Union type for all document elements
- */
-type DocumentElement = HeadingElement | ParagraphElement | ListElement | DynamicTextElement | BinaryChoiceElement | MultipleChoiceElement | SingleChoiceElement | RatingScaleElement | TextInputElement | DatePickerElement | SignatureElement | FileUploadElement;
-/**
- * Interface for document template
- */
-interface DocumentTemplate {
-    id: string;
-    title: string;
-    description?: string;
-    createdAt: number;
-    updatedAt: number;
-    createdBy: string;
-    elements: DocumentElement[];
-    tags?: string[];
-    isUserForm?: boolean;
-    isRequired?: boolean;
-    sortingOrder?: number;
-    version: number;
-    isActive: boolean;
-}
-/**
- * Interface for creating a new document template
- */
-interface CreateDocumentTemplateData {
-    title: string;
-    description?: string;
-    elements: Omit<DocumentElement, "id">[];
-    tags?: string[];
-    isUserForm?: boolean;
-    isRequired?: boolean;
-    sortingOrder?: number;
-}
-/**
- * Interface for updating an existing document template
- */
-interface UpdateDocumentTemplateData {
-    title?: string;
-    description?: string;
-    elements?: Omit<DocumentElement, "id">[];
-    tags?: string[];
-    isActive?: boolean;
-    isUserForm?: boolean;
-    isRequired?: boolean;
-    sortingOrder?: number;
-}
-/**
- * Interface for a filled document (completed form)
+ * Reference to a documentation template with metadata
+ * @property templateId - ID of the documentation template
+ * @property isUserForm - Whether this template is filled by users
+ * @property isRequired - Whether this template is required
+ * @property sortingOrder - The display order of this template
  */
-interface FilledDocument {
-    id: string;
+interface TechnologyDocumentationTemplate {
     templateId: string;
-    templateVersion: number;
     isUserForm: boolean;
     isRequired: boolean;
-    procedureId: string;
-    appointmentId: string;
-    patientId: string;
-    practitionerId: string;
-    clinicId: string;
-    createdAt: number;
-    updatedAt: number;
-    values: {
-        [elementId: string]: any;
-    };
-    status: FilledDocumentStatus;
-}
-/**
- * Enum for filled document status
- */
-declare enum FilledDocumentStatus {
-    DRAFT = "draft",
-    SKIPPED = "skipped",
-    PENDING = "pending",
-    COMPLETED = "completed",// When doctor or patient completes the form
-    SIGNED = "signed",// Only used for user forms
-    REJECTED = "rejected"
+    sortingOrder: number;
 }
-
 /**
  * Technology used in medical procedures
  * Technologies are now a top-level collection that reference their full path in the hierarchy
@@ -631,7 +384,7 @@ declare enum FilledDocumentStatus {
  * @property contraindications - List of conditions requiring special attention
  * @property benefits - List of expected benefits from the procedure
  * @property certificationRequirement - Required certification level and specialties
- * @property documentationTemplates - List of documentation templates required for this technology
+ * @property documentationTemplates - List of documentation template references
  * @property isActive - Whether the technology is active in the system
  * @property createdAt - Creation date
  * @property updatedAt - Last update date
@@ -652,7 +405,7 @@ interface Technology {
     contraindications: Contraindication[];
     benefits: TreatmentBenefit[];
     certificationRequirement: CertificationRequirement;
-    documentationTemplates?: DocumentTemplate[];
+    documentationTemplates?: TechnologyDocumentationTemplate[];
     isActive: boolean;
     createdAt: Date;
     updatedAt: Date;
@@ -797,7 +550,7 @@ interface Procedure {
     /** Certification requirements for performing this procedure */
     certificationRequirement: CertificationRequirement;
     /** Documentation templates required for this procedure */
-    documentationTemplates: DocumentTemplate[];
+    documentationTemplates: TechnologyDocumentationTemplate[];
     /** ID of the practitioner who performs this procedure */
     practitionerId: string;
     /** ID of the clinic branch where this procedure is performed */
@@ -1986,6 +1739,266 @@ interface PatientProfileInfo {
     gender: Gender;
 }
 
+/**
+ * Types for the Medical Documentation Templating System
+ */
+/**
+ * Kolekcija u Firestore bazi gde se čuvaju dokumentacijske šablone
+ */
+declare const DOCUMENTATION_TEMPLATES_COLLECTION = "documentation-templates";
+declare const FILLED_DOCUMENTS_COLLECTION = "filled-documents";
+declare const USER_FORMS_SUBCOLLECTION = "user-forms";
+declare const DOCTOR_FORMS_SUBCOLLECTION = "doctor-forms";
+/**
+ * Enum for element types in documentation templates
+ */
+declare enum DocumentElementType {
+    HEADING = "heading",
+    PARAGRAPH = "paragraph",
+    LIST = "list",
+    DYNAMIC_TEXT = "dynamic_text",
+    BINARY_CHOICE = "binary_choice",
+    MULTIPLE_CHOICE = "multiple_choice",
+    SINGLE_CHOICE = "single_choice",
+    RATING_SCALE = "rating_scale",
+    TEXT_INPUT = "text_input",
+    DATE_PICKER = "date_picker",
+    SIGNATURE = "signature",
+    DITIGAL_SIGNATURE = "digital_signature",
+    FILE_UPLOAD = "file_upload"
+}
+/**
+ * Enum for list types
+ */
+declare enum ListType {
+    ORDERED = "ordered",
+    UNORDERED = "unordered"
+}
+/**
+ * Enum for heading levels
+ */
+declare enum HeadingLevel {
+    H1 = "h1",
+    H2 = "h2",
+    H3 = "h3",
+    H4 = "h4",
+    H5 = "h5",
+    H6 = "h6"
+}
+/**
+ * Enum for dynamic variable placeholders
+ */
+declare enum DynamicVariable {
+    PATIENT_NAME = "$[PATIENT_NAME]",
+    DOCTOR_NAME = "$[DOCTOR_NAME]",
+    CLINIC_NAME = "$[CLINIC_NAME]",
+    PATIENT_BIRTHDAY = "$[PATIENT_BIRTHDAY]",
+    APPOINTMENT_DATE = "$[APPOINTMENT_DATE]",
+    CURRENT_DATE = "$[CURRENT_DATE]",
+    PROCEDURE_NAME = "$[PROCEDURE_NAME]",
+    PROCEDURE_DESCRIPTION = "$[PROCEDURE_DESCRIPTION]",
+    PROCEDURE_COST = "$[PROCEDURE_COST]",
+    PROCEDURE_DURATION = "$[PROCEDURE_DURATION]",
+    PROCEDURE_RISK = "$[PROCEDURE_RISK]"
+}
+/**
+ * Base interface for all document elements
+ */
+interface BaseDocumentElement {
+    id: string;
+    type: DocumentElementType;
+    required?: boolean;
+}
+/**
+ * Interface for heading element
+ */
+interface HeadingElement extends BaseDocumentElement {
+    type: DocumentElementType.HEADING;
+    text: string;
+    level: HeadingLevel;
+}
+/**
+ * Interface for paragraph element
+ */
+interface ParagraphElement extends BaseDocumentElement {
+    type: DocumentElementType.PARAGRAPH;
+    text: string;
+}
+/**
+ * Interface for list element
+ */
+interface ListElement extends BaseDocumentElement {
+    type: DocumentElementType.LIST;
+    items: string[];
+    listType: ListType;
+}
+/**
+ * Interface for dynamic text element
+ */
+interface DynamicTextElement extends BaseDocumentElement {
+    type: DocumentElementType.DYNAMIC_TEXT;
+    text: string;
+}
+/**
+ * Interface for binary choice element (Yes/No)
+ */
+interface BinaryChoiceElement extends BaseDocumentElement {
+    type: DocumentElementType.BINARY_CHOICE;
+    question: string;
+    defaultValue?: boolean;
+}
+/**
+ * Interface for multiple choice element
+ */
+interface MultipleChoiceElement extends BaseDocumentElement {
+    type: DocumentElementType.MULTIPLE_CHOICE;
+    question: string;
+    options: string[];
+    defaultValues?: string[];
+}
+/**
+ * Interface for single choice element
+ */
+interface SingleChoiceElement extends BaseDocumentElement {
+    type: DocumentElementType.SINGLE_CHOICE;
+    question: string;
+    options: string[];
+    defaultValue?: string;
+}
+/**
+ * Interface for rating scale element
+ */
+interface RatingScaleElement extends BaseDocumentElement {
+    type: DocumentElementType.RATING_SCALE;
+    question: string;
+    min: number;
+    max: number;
+    labels?: {
+        [key: number]: string;
+    };
+    defaultValue?: number;
+}
+/**
+ * Interface for text input element
+ */
+interface TextInputElement extends BaseDocumentElement {
+    type: DocumentElementType.TEXT_INPUT;
+    label: string;
+    placeholder?: string;
+    multiline?: boolean;
+    defaultValue?: string;
+}
+/**
+ * Interface for date picker element
+ */
+interface DatePickerElement extends BaseDocumentElement {
+    type: DocumentElementType.DATE_PICKER;
+    label: string;
+    defaultValue?: string;
+}
+/**
+ * Interface for signature element
+ */
+interface SignatureElement extends BaseDocumentElement {
+    type: DocumentElementType.SIGNATURE;
+    label: string;
+}
+/**
+ * Interface for digital signature element
+ */
+interface DigitalSignatureElement extends BaseDocumentElement {
+    type: DocumentElementType.DITIGAL_SIGNATURE;
+    label: string;
+}
+/**
+ * Interface for file upload element
+ */
+interface FileUploadElement extends BaseDocumentElement {
+    type: DocumentElementType.FILE_UPLOAD;
+    label: string;
+    allowedFileTypes?: string[];
+    maxFileSizeMB?: number;
+}
+/**
+ * Union type for all document elements
+ */
+type DocumentElement = HeadingElement | ParagraphElement | ListElement | DynamicTextElement | BinaryChoiceElement | MultipleChoiceElement | SingleChoiceElement | RatingScaleElement | TextInputElement | DatePickerElement | SignatureElement | FileUploadElement;
+/**
+ * Interface for document template
+ */
+interface DocumentTemplate {
+    id: string;
+    title: string;
+    description?: string;
+    createdAt: number;
+    updatedAt: number;
+    createdBy: string;
+    elements: DocumentElement[];
+    tags?: string[];
+    isUserForm?: boolean;
+    isRequired?: boolean;
+    sortingOrder?: number;
+    version: number;
+    isActive: boolean;
+}
+/**
+ * Interface for creating a new document template
+ */
+interface CreateDocumentTemplateData {
+    title: string;
+    description?: string;
+    elements: Omit<DocumentElement, "id">[];
+    tags?: string[];
+    isUserForm?: boolean;
+    isRequired?: boolean;
+    sortingOrder?: number;
+}
+/**
+ * Interface for updating an existing document template
+ */
+interface UpdateDocumentTemplateData {
+    title?: string;
+    description?: string;
+    elements?: Omit<DocumentElement, "id">[];
+    tags?: string[];
+    isActive?: boolean;
+    isUserForm?: boolean;
+    isRequired?: boolean;
+    sortingOrder?: number;
+}
+/**
+ * Interface for a filled document (completed form)
+ */
+interface FilledDocument {
+    id: string;
+    templateId: string;
+    templateVersion: number;
+    isUserForm: boolean;
+    isRequired: boolean;
+    procedureId: string;
+    appointmentId: string;
+    patientId: string;
+    practitionerId: string;
+    clinicId: string;
+    createdAt: number;
+    updatedAt: number;
+    values: {
+        [elementId: string]: any;
+    };
+    status: FilledDocumentStatus;
+}
+/**
+ * Enum for filled document status
+ */
+declare enum FilledDocumentStatus {
+    DRAFT = "draft",
+    SKIPPED = "skipped",
+    PENDING = "pending",
+    COMPLETED = "completed",// When doctor or patient completes the form
+    SIGNED = "signed",// Only used for user forms
+    REJECTED = "rejected"
+}
+
 /**
  * Brend proizvoda ili opreme
  * Predstavlja proizvođača ili dobavljača proizvoda i opreme koja se koristi u procedurama
@@ -4103,7 +4116,7 @@ declare class TechnologyService extends BaseService {
             pre: Requirement[];
             post: Requirement[];
         };
-        documentationTemplates?: DocumentTemplate[] | undefined;
+        documentationTemplates?: TechnologyDocumentationTemplate[] | undefined;
         benefits: TreatmentBenefit[];
         certificationRequirement: CertificationRequirement;
         id: string;
@@ -6491,6 +6504,7 @@ declare class FilledDocumentService extends BaseService {
     /**
      * Create a new filled document within an appointment's subcollection.
      * @param templateId - ID of the template to use.
+     * @param templateVersion - Version of the template to use.
      * @param appointmentId - ID of the appointment this form belongs to.
      * @param procedureId - ID of the procedure associated with this form.
      * @param patientId - ID of the patient.
@@ -6500,7 +6514,7 @@ declare class FilledDocumentService extends BaseService {
      * @param initialStatus - Optional initial status for the form.
      * @returns The created filled document.
      */
-    createFilledDocumentForAppointment(templateId: string, appointmentId: string, procedureId: string, patientId: string, practitionerId: string, // Consider if this is always available or if a placeholder is needed
+    createFilledDocumentForAppointment(templateId: string, templateVersion: number, appointmentId: string, procedureId: string, patientId: string, practitionerId: string, // Consider if this is always available or if a placeholder is needed
     clinicId: string, // Same consideration as practitionerId
     initialValues?: {
         [elementId: string]: any;

package/dist/index.js

@@ -8430,25 +8430,30 @@ var DocumentationTemplateService = class extends BaseService {
    * @returns The template or null if not found
    */
   async getTemplateById(templateId, version) {
-    if (version !== void 0) {
-      try {
-        const versionTemplate = await this.getTemplateVersion(
-          templateId,
-          version
-        );
-        if (versionTemplate) {
-          return versionTemplate;
-        }
-      } catch (error) {
-        console.error(`Error getting template version ${version}:`, error);
-      }
-    }
     const docRef = (0, import_firestore25.doc)(this.collectionRef, templateId);
     const docSnap = await (0, import_firestore25.getDoc)(docRef);
     if (!docSnap.exists()) {
       return null;
     }
-    return docSnap.data();
+    const currentTemplate = docSnap.data();
+    if (version === void 0) {
+      return currentTemplate;
+    }
+    if (currentTemplate.version === version) {
+      return currentTemplate;
+    }
+    try {
+      const versionTemplate = await this.getTemplateVersion(
+        templateId,
+        version
+      );
+      if (versionTemplate) {
+        return versionTemplate;
+      }
+    } catch (error) {
+      console.error(`Error getting template version ${version}:`, error);
+    }
+    return null;
   }
   /**
    * Update an existing document template
@@ -8670,6 +8675,7 @@ var FilledDocumentService = class extends BaseService {
   /**
    * Create a new filled document within an appointment's subcollection.
    * @param templateId - ID of the template to use.
+   * @param templateVersion - Version of the template to use.
    * @param appointmentId - ID of the appointment this form belongs to.
    * @param procedureId - ID of the procedure associated with this form.
    * @param patientId - ID of the patient.
@@ -8679,8 +8685,11 @@ var FilledDocumentService = class extends BaseService {
    * @param initialStatus - Optional initial status for the form.
    * @returns The created filled document.
    */
-  async createFilledDocumentForAppointment(templateId, appointmentId, procedureId, patientId, practitionerId, clinicId, initialValues = {}, initialStatus = "draft" /* DRAFT */) {
-    const template = await this.templateService.getTemplateById(templateId);
+  async createFilledDocumentForAppointment(templateId, templateVersion, appointmentId, procedureId, patientId, practitionerId, clinicId, initialValues = {}, initialStatus = "draft" /* DRAFT */) {
+    const template = await this.templateService.getTemplateById(
+      templateId,
+      templateVersion
+    );
     if (!template) {
       throw new Error(`Template with ID ${templateId} not found`);
     }