@blackcode_sa/metaestetics-api 1.12.58 → 1.12.61

package/src/types/patient/medical-info.types.ts

@@ -1,152 +1,152 @@
-import { Timestamp } from "firebase/firestore";
-import { BlockingCondition } from "../../backoffice/types/static/blocking-condition.types";
-import { AllergyType, AllergySubtype } from "./allergies";
-import type { ContraindicationDynamic } from "../../backoffice";
-
-export const PATIENT_MEDICAL_INFO_COLLECTION = "medical_info";
-
-export interface Allergy {
-  type: AllergyType;
-  subtype: AllergySubtype;
-  name?: string | null;
-  severity?: "mild" | "moderate" | "severe" | null;
-  reaction?: string | null;
-  diagnosed?: Timestamp | null;
-  notes?: string | null;
-}
-
-export interface VitalStats {
-  height?: number;
-  weight?: number;
-  bloodType?: "A+" | "A-" | "B+" | "B-" | "AB+" | "AB-" | "O+" | "O-";
-  bloodPressure?: {
-    systolic: number;
-    diastolic: number;
-    lastMeasured: Timestamp;
-  };
-}
-
-export interface PatientMedicalInfo {
-  patientId: string;
-  vitalStats: VitalStats;
-
-  blockingConditions: {
-    condition: BlockingCondition;
-    diagnosedAt: Timestamp;
-    isActive: boolean;
-    notes?: string | null;
-  }[];
-
-  contraindications: {
-    condition: ContraindicationDynamic;
-    lastOccurrence: Timestamp;
-    frequency: "rare" | "occasional" | "frequent";
-    isActive: boolean;
-    notes?: string | null;
-  }[];
-
-  allergies: Allergy[];
-
-  currentMedications: {
-    name: string;
-    dosage: string;
-    frequency: string;
-    startDate?: Timestamp | null;
-    endDate?: Timestamp | null;
-    prescribedBy?: string | null;
-  }[];
-
-  emergencyNotes?: string;
-
-  lastUpdated: Timestamp;
-  updatedBy: string;
-  verifiedBy?: string;
-  verifiedAt?: Timestamp;
-}
-
-export type CreatePatientMedicalInfoData = Omit<
-  PatientMedicalInfo,
-  "patientId" | "lastUpdated" | "updatedBy" | "verifiedBy" | "verifiedAt"
->;
-export type UpdatePatientMedicalInfoData =
-  Partial<CreatePatientMedicalInfoData>;
-
-// Interfejsi za ažuriranje vitalnih statistika
-export interface UpdateVitalStatsData {
-  height?: number;
-  weight?: number;
-  bloodType?: "A+" | "A-" | "B+" | "B-" | "AB+" | "AB-" | "O+" | "O-";
-  bloodPressure?: {
-    systolic: number;
-    diastolic: number;
-    lastMeasured: Timestamp;
-  };
-}
-
-// Interfejsi za alergije
-export interface AddAllergyData {
-  type: AllergyType;
-  subtype: AllergySubtype;
-  name?: string | null;
-  severity?: "mild" | "moderate" | "severe";
-  reaction?: string | null;
-  diagnosed?: Timestamp | null;
-  notes?: string | null;
-}
-
-export interface UpdateAllergyData extends Partial<AddAllergyData> {
-  allergyIndex: number;
-}
-
-// Interfejsi za blocking conditions
-export interface AddBlockingConditionData {
-  condition: BlockingCondition;
-  diagnosedAt: Timestamp;
-  isActive: boolean;
-  notes?: string;
-}
-
-export interface UpdateBlockingConditionData
-  extends Partial<AddBlockingConditionData> {
-  conditionIndex: number;
-}
-
-// Interfejsi za kontraindikacije
-export interface AddContraindicationData {
-  condition: ContraindicationDynamic;
-  lastOccurrence: Timestamp;
-  frequency: "rare" | "occasional" | "frequent";
-  isActive: boolean;
-  notes?: string;
-}
-
-export interface UpdateContraindicationData
-  extends Partial<AddContraindicationData> {
-  contraindicationIndex: number;
-}
-
-// Interfejsi za medikacije
-export interface AddMedicationData {
-  name: string;
-  dosage: string;
-  frequency: string;
-  startDate: Timestamp;
-  endDate?: Timestamp;
-  prescribedBy?: string;
-}
-
-export interface UpdateMedicationData extends Partial<AddMedicationData> {
-  medicationIndex: number;
-}
-
-// Default vrednosti za prazan medicinski dokument
-export const DEFAULT_MEDICAL_INFO: Omit<
-  PatientMedicalInfo,
-  "patientId" | "lastUpdated" | "updatedBy"
-> = {
-  vitalStats: {},
-  blockingConditions: [],
-  contraindications: [],
-  allergies: [],
-  currentMedications: [],
-};
+import { Timestamp } from "firebase/firestore";
+import { BlockingCondition } from "../../backoffice/types/static/blocking-condition.types";
+import { AllergyType, AllergySubtype } from "./allergies";
+import type { ContraindicationDynamic } from "../../backoffice";
+
+export const PATIENT_MEDICAL_INFO_COLLECTION = "medical_info";
+
+export interface Allergy {
+  type: AllergyType;
+  subtype: AllergySubtype;
+  name?: string | null;
+  severity?: "mild" | "moderate" | "severe" | null;
+  reaction?: string | null;
+  diagnosed?: Timestamp | null;
+  notes?: string | null;
+}
+
+export interface VitalStats {
+  height?: number;
+  weight?: number;
+  bloodType?: "A+" | "A-" | "B+" | "B-" | "AB+" | "AB-" | "O+" | "O-";
+  bloodPressure?: {
+    systolic: number;
+    diastolic: number;
+    lastMeasured: Timestamp;
+  };
+}
+
+export interface PatientMedicalInfo {
+  patientId: string;
+  vitalStats: VitalStats;
+
+  blockingConditions: {
+    condition: BlockingCondition;
+    diagnosedAt: Timestamp;
+    isActive: boolean;
+    notes?: string | null;
+  }[];
+
+  contraindications: {
+    condition: ContraindicationDynamic;
+    lastOccurrence: Timestamp;
+    frequency: "rare" | "occasional" | "frequent";
+    isActive: boolean;
+    notes?: string | null;
+  }[];
+
+  allergies: Allergy[];
+
+  currentMedications: {
+    name: string;
+    dosage: string;
+    frequency: string;
+    startDate?: Timestamp | null;
+    endDate?: Timestamp | null;
+    prescribedBy?: string | null;
+  }[];
+
+  emergencyNotes?: string;
+
+  lastUpdated: Timestamp;
+  updatedBy: string;
+  verifiedBy?: string;
+  verifiedAt?: Timestamp;
+}
+
+export type CreatePatientMedicalInfoData = Omit<
+  PatientMedicalInfo,
+  "patientId" | "lastUpdated" | "updatedBy" | "verifiedBy" | "verifiedAt"
+>;
+export type UpdatePatientMedicalInfoData =
+  Partial<CreatePatientMedicalInfoData>;
+
+// Interfejsi za ažuriranje vitalnih statistika
+export interface UpdateVitalStatsData {
+  height?: number;
+  weight?: number;
+  bloodType?: "A+" | "A-" | "B+" | "B-" | "AB+" | "AB-" | "O+" | "O-";
+  bloodPressure?: {
+    systolic: number;
+    diastolic: number;
+    lastMeasured: Timestamp;
+  };
+}
+
+// Interfejsi za alergije
+export interface AddAllergyData {
+  type: AllergyType;
+  subtype: AllergySubtype;
+  name?: string | null;
+  severity?: "mild" | "moderate" | "severe";
+  reaction?: string | null;
+  diagnosed?: Timestamp | null;
+  notes?: string | null;
+}
+
+export interface UpdateAllergyData extends Partial<AddAllergyData> {
+  allergyIndex: number;
+}
+
+// Interfejsi za blocking conditions
+export interface AddBlockingConditionData {
+  condition: BlockingCondition;
+  diagnosedAt: Timestamp;
+  isActive: boolean;
+  notes?: string;
+}
+
+export interface UpdateBlockingConditionData
+  extends Partial<AddBlockingConditionData> {
+  conditionIndex: number;
+}
+
+// Interfejsi za kontraindikacije
+export interface AddContraindicationData {
+  condition: ContraindicationDynamic;
+  lastOccurrence: Timestamp;
+  frequency: "rare" | "occasional" | "frequent";
+  isActive: boolean;
+  notes?: string;
+}
+
+export interface UpdateContraindicationData
+  extends Partial<AddContraindicationData> {
+  contraindicationIndex: number;
+}
+
+// Interfejsi za medikacije
+export interface AddMedicationData {
+  name: string;
+  dosage: string;
+  frequency: string;
+  startDate: Timestamp;
+  endDate?: Timestamp;
+  prescribedBy?: string;
+}
+
+export interface UpdateMedicationData extends Partial<AddMedicationData> {
+  medicationIndex: number;
+}
+
+// Default vrednosti za prazan medicinski dokument
+export const DEFAULT_MEDICAL_INFO: Omit<
+  PatientMedicalInfo,
+  "patientId" | "lastUpdated" | "updatedBy"
+> = {
+  vitalStats: {},
+  blockingConditions: [],
+  contraindications: [],
+  allergies: [],
+  currentMedications: [],
+};

package/src/types/patient/patient-requirements.ts

@@ -1,81 +1,92 @@
-import { Timestamp } from "firebase/firestore";
-import {
-  RequirementType,
-  RequirementImportance,
-  TimeFrame,
-} from "../../backoffice/types/requirement.types";
-
-/**
- * Defines the status of a specific instruction within a PatientRequirementInstance.
- * This helps track each actionable item for the patient.
- */
-export enum PatientInstructionStatus {
-  PENDING_NOTIFICATION = "pendingNotification", // Notification is scheduled but not yet due/sent
-  ACTION_DUE = "actionDue", // The time for this instruction/notification has arrived
-  ACTION_TAKEN = "actionTaken", // Patient has acknowledged or completed this specific instruction
-  MISSED = "missed", // The due time for this instruction passed without action
-  CANCELLED = "cancelled", // This specific instruction was cancelled (e.g., requirement changed)
-  SKIPPED = "skipped", // This specific instruction was skipped (e.g., patient did not want to do it)
-}
-
-/**
- * Represents a single, timed instruction or notification point derived from a Requirement's timeframe.
- */
-export interface PatientRequirementInstruction {
-  instructionId: string; // Unique ID for this specific instruction (e.g., originalRequirementId + notifyAtIndex)
-  instructionText: string; // The specific text for this instruction (e.g., "Do not drink water")
-
-  dueTime: Timestamp; // When this instruction is due, or when the notification for it should be sent
-  actionableWindow: number; // The number of hours before the due time that the instruction is actionable (e.g., 24 hours), after this it will marked as missed if not completed
-  status: PatientInstructionStatus;
-
-  originalNotifyAtValue: number; // The original 'notifyAt' value from Requirement.timeframe.notifyAt (e.g. 2 for 2 hours before)
-  originalTimeframeUnit: TimeFrame["unit"]; // e.g. 'hours' or 'days'
-
-  notificationId?: string; // ID of the notification created for this instruction
-  actionTakenAt?: Timestamp; // When the patient marked this specific instruction as actioned
-  updatedAt: Timestamp; // Last update to this instruction's status/details
-}
-
-/**
- * Defines the overall status of a PatientRequirementInstance.
- */
-export enum PatientRequirementOverallStatus {
-  ACTIVE = "active", // Requirement instance is active, instructions are pending or due.
-  ALL_INSTRUCTIONS_MET = "allInstructionsMet", // All instructions actioned/completed by the patient.
-  PARTIALLY_COMPLETED = "partiallyCompleted", // Some instructions met, some missed or pending.
-  FAILED = "failed", // The patient failed to complete the requirement on time and above treashold of 60%
-  CANCELLED_APPOINTMENT = "cancelledAppointment", // Entire requirement instance cancelled due to appointment cancellation.
-  SUPERSEDED_RESCHEDULE = "supersededReschedule", // This instance was replaced by a new one due to appointment reschedule.
-  FAILED_TO_PROCESS = "failedToProcess", // An error occurred during its creation or initial processing.
-}
-
-/**
- * Represents an instance of a backoffice Requirement, tailored to a specific patient and appointment.
- * This document lives in the patient's subcollection: `patients/{patientId}/patientRequirements/{instanceId}`.
- */
-export interface PatientRequirementInstance {
-  id: string; // Firestore document ID
-  patientId: string;
-  appointmentId: string;
-
-  originalRequirementId: string; // ID of the base Requirement from `backoffice_requirements`
-  requirementType: RequirementType; // 'pre' or 'post', copied from original
-  requirementName: string; // Copied from original (for display)
-  requirementDescription: string; // Copied from original (overall description)
-  requirementImportance: RequirementImportance; // Copied from original
-
-  overallStatus: PatientRequirementOverallStatus; // Overall status of this requirement instance
-
-  // Contains each specific timed instruction derived from the Requirement's timeframe.notifyAt
-  instructions: PatientRequirementInstruction[];
-
-  // Timestamps for the instance itself
-  createdAt: Timestamp;
-  updatedAt: Timestamp;
-}
-
-/**
- * Firestore subcollection name for patient requirement instances.
- */
-export const PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME = "patientRequirements";
+import { Timestamp } from "firebase/firestore";
+import {
+  RequirementType,
+  RequirementImportance,
+  TimeFrame,
+} from "../../backoffice/types/requirement.types";
+
+/**
+ * Defines the status of a specific instruction within a PatientRequirementInstance.
+ * This helps track each actionable item for the patient.
+ */
+export enum PatientInstructionStatus {
+  PENDING_NOTIFICATION = "pendingNotification", // Notification is scheduled but not yet due/sent
+  ACTION_DUE = "actionDue", // The time for this instruction/notification has arrived
+  ACTION_TAKEN = "actionTaken", // Patient has acknowledged or completed this specific instruction
+  MISSED = "missed", // The due time for this instruction passed without action
+  CANCELLED = "cancelled", // This specific instruction was cancelled (e.g., requirement changed)
+  SKIPPED = "skipped", // This specific instruction was skipped (e.g., patient did not want to do it)
+}
+
+/**
+ * Represents a single, timed instruction or notification point derived from a Requirement's timeframe.
+ */
+export interface PatientRequirementInstruction {
+  instructionId: string; // Unique ID for this specific instruction (e.g., originalRequirementId + notifyAtIndex)
+  instructionText: string; // The specific text for this instruction (e.g., "Do not drink water")
+
+  dueTime: Timestamp; // When this instruction is due, or when the notification for it should be sent
+  actionableWindow: number; // The number of hours before the due time that the instruction is actionable (e.g., 24 hours), after this it will marked as missed if not completed
+  status: PatientInstructionStatus;
+
+  originalNotifyAtValue: number; // The original 'notifyAt' value from Requirement.timeframe.notifyAt (e.g. 2 for 2 hours before)
+  originalTimeframeUnit: TimeFrame["unit"]; // e.g. 'hours' or 'days'
+
+  notificationId?: string; // ID of the notification created for this instruction
+  actionTakenAt?: Timestamp; // When the patient marked this specific instruction as actioned
+  updatedAt: Timestamp; // Last update to this instruction's status/details
+}
+
+/**
+ * Defines the overall status of a PatientRequirementInstance.
+ */
+export enum PatientRequirementOverallStatus {
+  ACTIVE = "active", // Requirement instance is active, instructions are pending or due.
+  ALL_INSTRUCTIONS_MET = "allInstructionsMet", // All instructions actioned/completed by the patient.
+  PARTIALLY_COMPLETED = "partiallyCompleted", // Some instructions met, some missed or pending.
+  FAILED = "failed", // The patient failed to complete the requirement on time and above treashold of 60%
+  CANCELLED_APPOINTMENT = "cancelledAppointment", // Entire requirement instance cancelled due to appointment cancellation.
+  SUPERSEDED_RESCHEDULE = "supersededReschedule", // This instance was replaced by a new one due to appointment reschedule.
+  FAILED_TO_PROCESS = "failedToProcess", // An error occurred during its creation or initial processing.
+}
+
+/**
+ * Represents source procedure information for a requirement instance
+ */
+export interface RequirementSourceProcedure {
+  procedureId: string;
+  procedureName: string;
+}
+
+/**
+ * Represents an instance of a backoffice Requirement, tailored to a specific patient and appointment.
+ * This document lives in the patient's subcollection: `patients/{patientId}/patientRequirements/{instanceId}`.
+ */
+export interface PatientRequirementInstance {
+  id: string; // Firestore document ID
+  patientId: string;
+  appointmentId: string;
+
+  originalRequirementId: string; // ID of the base Requirement from `backoffice_requirements`
+  requirementType: RequirementType; // 'pre' or 'post', copied from original
+  requirementName: string; // Copied from original (for display)
+  requirementDescription: string; // Copied from original (overall description)
+  requirementImportance: RequirementImportance; // Copied from original
+
+  overallStatus: PatientRequirementOverallStatus; // Overall status of this requirement instance
+
+  // Contains each specific timed instruction derived from the Requirement's timeframe.notifyAt
+  instructions: PatientRequirementInstruction[];
+
+  // NEW: Track which procedure(s) this requirement comes from
+  sourceProcedures?: RequirementSourceProcedure[];
+
+  // Timestamps for the instance itself
+  createdAt: Timestamp;
+  updatedAt: Timestamp;
+}
+
+/**
+ * Firestore subcollection name for patient requirement instances.
+ */
+export const PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME = "patientRequirements";

package/src/types/patient/token.types.ts

@@ -1,61 +1,61 @@
-import { Timestamp } from "firebase/firestore";
-
-export const INVITE_TOKENS_COLLECTION = "inviteTokens";
-
-/**
- * @enum PatientTokenStatus
- * @description Represents the status of a patient registration token.
- * @property {string} ACTIVE - The token is active and can be used for registration.
- * @property {string} USED - The token has been used and is no longer valid.
- * @property {string} EXPIRED - The token has expired and is no longer valid.
- */
-export enum PatientTokenStatus {
-  ACTIVE = "active",
-  USED = "used",
-  EXPIRED = "expired",
-}
-
-/**
- * @interface PatientToken
- * @description Represents a registration token for a patient to claim their profile.
- * These tokens are stored in a subcollection under the patient's profile.
- * @property {string} id - The unique identifier for the token document.
- * @property {string} token - The unique token string (e.g., a 6-character code).
- * @property {string} patientId - The ID of the patient profile this token is for.
- * @property {string} email - The email address the invitation was sent to.
- * @property {string} clinicId - The ID of the clinic that created the invitation.
- * @property {PatientTokenStatus} status - The current status of the token.
- * @property {string} createdBy - The ID of the admin user who created the token.
- * @property {Timestamp} createdAt - The timestamp when the token was created.
- * @property {Timestamp} expiresAt - The timestamp when the token expires.
- * @property {string} [usedBy] - The ID of the user who used the token (optional).
- * @property {Timestamp} [usedAt] - The timestamp when the token was used (optional).
- */
-export interface PatientToken {
-  id: string;
-  token: string;
-  patientId: string;
-  email: string;
-  clinicId: string;
-  status: PatientTokenStatus;
-  createdBy: string;
-  createdAt: Timestamp;
-  expiresAt: Timestamp;
-  usedBy?: string;
-  usedAt?: Timestamp;
-}
-
-/**
- * @interface CreatePatientTokenData
- * @description Represents the data required to create a new patient registration token.
- * @property {string} patientId - The ID of the patient to generate the token for.
- * @property {string} clinicId - The ID of the clinic creating the token.
- * @property {string} email - The email to associate with the token.
- * @property {Date} [expiresAt] - The optional expiration date for the token. Defaults to 7 days from creation.
- */
-export interface CreatePatientTokenData {
-  patientId: string;
-  clinicId: string;
-  email: string;
-  expiresAt?: Date;
-}
+import { Timestamp } from "firebase/firestore";
+
+export const INVITE_TOKENS_COLLECTION = "inviteTokens";
+
+/**
+ * @enum PatientTokenStatus
+ * @description Represents the status of a patient registration token.
+ * @property {string} ACTIVE - The token is active and can be used for registration.
+ * @property {string} USED - The token has been used and is no longer valid.
+ * @property {string} EXPIRED - The token has expired and is no longer valid.
+ */
+export enum PatientTokenStatus {
+  ACTIVE = "active",
+  USED = "used",
+  EXPIRED = "expired",
+}
+
+/**
+ * @interface PatientToken
+ * @description Represents a registration token for a patient to claim their profile.
+ * These tokens are stored in a subcollection under the patient's profile.
+ * @property {string} id - The unique identifier for the token document.
+ * @property {string} token - The unique token string (e.g., a 6-character code).
+ * @property {string} patientId - The ID of the patient profile this token is for.
+ * @property {string} email - The email address the invitation was sent to.
+ * @property {string} clinicId - The ID of the clinic that created the invitation.
+ * @property {PatientTokenStatus} status - The current status of the token.
+ * @property {string} createdBy - The ID of the admin user who created the token.
+ * @property {Timestamp} createdAt - The timestamp when the token was created.
+ * @property {Timestamp} expiresAt - The timestamp when the token expires.
+ * @property {string} [usedBy] - The ID of the user who used the token (optional).
+ * @property {Timestamp} [usedAt] - The timestamp when the token was used (optional).
+ */
+export interface PatientToken {
+  id: string;
+  token: string;
+  patientId: string;
+  email: string;
+  clinicId: string;
+  status: PatientTokenStatus;
+  createdBy: string;
+  createdAt: Timestamp;
+  expiresAt: Timestamp;
+  usedBy?: string;
+  usedAt?: Timestamp;
+}
+
+/**
+ * @interface CreatePatientTokenData
+ * @description Represents the data required to create a new patient registration token.
+ * @property {string} patientId - The ID of the patient to generate the token for.
+ * @property {string} clinicId - The ID of the clinic creating the token.
+ * @property {string} email - The email to associate with the token.
+ * @property {Date} [expiresAt] - The optional expiration date for the token. Defaults to 7 days from creation.
+ */
+export interface CreatePatientTokenData {
+  patientId: string;
+  clinicId: string;
+  email: string;
+  expiresAt?: Date;
+}