@blackcode_sa/metaestetics-api 1.5.16 → 1.5.17

package/src/types/calendar/index.ts

@@ -185,3 +185,44 @@ export interface UpdateAppointmentParams {
  * Collection names for calendar
  */
 export const CALENDAR_COLLECTION = "calendar";
+
+/**
+ * Enum for specifying the primary search location for calendar events
+ */
+export enum SearchLocationEnum {
+  PRACTITIONER = "practitioner",
+  PATIENT = "patient",
+  CLINIC = "clinic", // Represents searching events associated with a clinic
+}
+
+/**
+ * Interface for defining a date range
+ */
+export interface DateRange {
+  start: Timestamp;
+  end: Timestamp;
+}
+
+/**
+ * Interface for general calendar event search parameters
+ */
+export interface SearchCalendarEventsParams {
+  /** The primary location to search within (practitioner, patient, or clinic calendar). */
+  searchLocation: SearchLocationEnum;
+  /** The ID of the entity (practitioner, patient, or clinic) whose calendar/events are being searched. */
+  entityId: string;
+  /** Optional filter for clinic ID. If searchLocation is CLINIC, this is implicitly applied using entityId. */
+  clinicId?: string;
+  /** Optional filter for practitioner ID. */
+  practitionerId?: string;
+  /** Optional filter for patient ID. */
+  patientId?: string;
+  /** Optional filter for procedure ID. */
+  procedureId?: string;
+  /** Optional filter for a specific date range (based on event start time). */
+  dateRange?: DateRange;
+  /** Optional filter for event status. */
+  eventStatus?: CalendarEventStatus;
+  /** Optional filter for event type. */
+  eventType?: CalendarEventType;
+}

package/src/types/patient/index.ts

@@ -172,6 +172,8 @@ export interface PatientProfile {
   dateOfBirth?: Timestamp | null;
   doctors: PatientDoctor[]; // Lista doktora pacijenta
   clinics: PatientClinic[]; // Lista klinika pacijenta
+  doctorIds: string[]; // Denormalized array for querying
+  clinicIds: string[]; // Denormalized array for querying
   createdAt: Timestamp;
   updatedAt: Timestamp;
 }
@@ -188,14 +190,42 @@ export interface CreatePatientProfileData {
   isVerified: boolean;
   doctors?: PatientDoctor[];
   clinics?: PatientClinic[];
+  doctorIds?: string[]; // Initialize as empty or with initial doctors
+  clinicIds?: string[]; // Initialize as empty or with initial clinics
 }
 
 /**
  * Tip za ažuriranje Patient profila
  */
 export interface UpdatePatientProfileData
-  extends Partial<CreatePatientProfileData> {
+  extends Partial<Omit<PatientProfile, "id" | "createdAt" | "updatedAt">> {
+  // Use Omit to exclude base fields
   updatedAt?: FieldValue;
+  // Note: doctors, clinics, doctorIds, clinicIds should ideally be updated via specific methods (add/removeDoctor/Clinic)
+}
+
+/**
+ * Parameters for searching patient profiles.
+ */
+export interface SearchPatientsParams {
+  /** Optional: Filter patients associated with this clinic ID. */
+  clinicId?: string;
+  /** Optional: Filter patients associated with this practitioner ID. */
+  practitionerId?: string;
+}
+
+/**
+ * Information about the entity requesting the patient search.
+ */
+export interface RequesterInfo {
+  /** ID of the clinic admin user or practitioner user making the request. */
+  id: string;
+  /** Role of the requester, determining the search context. */
+  role: "clinic_admin" | "practitioner";
+  /** If role is 'clinic_admin', this is the associated clinic ID. */
+  associatedClinicId?: string;
+  /** If role is 'practitioner', this is the associated practitioner profile ID. */
+  associatedPractitionerId?: string;
 }
 
 export * from "./medical-info.types";

package/src/types/practitioner/index.ts

@@ -1,11 +1,11 @@
-import { Timestamp, FieldValue } from "firebase/firestore";
+import { Timestamp, FieldValue } from 'firebase/firestore';
 import {
   CertificationLevel,
   CertificationSpecialty,
-} from "../../backoffice/types/static/certification.types";
+} from '../../backoffice/types/static/certification.types';
 
-export const PRACTITIONERS_COLLECTION = "practitioners";
-export const REGISTER_TOKENS_COLLECTION = "register_tokens";
+export const PRACTITIONERS_COLLECTION = 'practitioners';
+export const REGISTER_TOKENS_COLLECTION = 'register_tokens';
 
 /**
  * Osnovne informacije o zdravstvenom radniku
@@ -17,7 +17,7 @@ export interface PractitionerBasicInfo {
   email: string;
   phoneNumber: string;
   dateOfBirth: Timestamp;
-  gender: "male" | "female" | "other";
+  gender: 'male' | 'female' | 'other';
   profileImageUrl?: string;
   bio?: string;
   languages: string[];
@@ -33,7 +33,7 @@ export interface PractitionerCertification {
   issuingAuthority: string;
   issueDate: Timestamp;
   expiryDate?: Timestamp;
-  verificationStatus: "pending" | "verified" | "rejected";
+  verificationStatus: 'pending' | 'verified' | 'rejected';
 }
 
 /**
@@ -59,18 +59,18 @@ export interface PractitionerClinicWorkingHours {
  * Status of practitioner profile
  */
 export enum PractitionerStatus {
-  DRAFT = "draft",
-  ACTIVE = "active",
+  DRAFT = 'draft',
+  ACTIVE = 'active',
 }
 
 /**
  * Token status for practitioner invitations
  */
 export enum PractitionerTokenStatus {
-  ACTIVE = "active",
-  USED = "used",
-  EXPIRED = "expired",
-  REVOKED = "revoked",
+  ACTIVE = 'active',
+  USED = 'used',
+  EXPIRED = 'expired',
+  REVOKED = 'revoked',
 }
 
 /**
@@ -119,8 +119,7 @@ export interface CreateDraftPractitionerData {
 /**
  * Tip za ažuriranje zdravstvenog radnika
  */
-export interface UpdatePractitionerData
-  extends Partial<CreatePractitionerData> {
+export interface UpdatePractitionerData extends Partial<CreatePractitionerData> {
   updatedAt?: FieldValue;
 }
 

package/src/validations/patient.schema.ts

@@ -115,6 +115,8 @@ export const patientProfileSchema = z.object({
   isVerified: z.boolean(),
   doctors: z.array(patientDoctorSchema),
   clinics: z.array(patientClinicSchema),
+  doctorIds: z.array(z.string()),
+  clinicIds: z.array(z.string()),
   createdAt: z.instanceof(Timestamp),
   updatedAt: z.instanceof(Timestamp),
 });
@@ -132,6 +134,8 @@ export const createPatientProfileSchema = z.object({
   isVerified: z.boolean(),
   doctors: z.array(patientDoctorSchema).optional(),
   clinics: z.array(patientClinicSchema).optional(),
+  doctorIds: z.array(z.string()).optional(),
+  clinicIds: z.array(z.string()).optional(),
 });
 
 /**
@@ -152,4 +156,43 @@ export const createPatientSensitiveInfoSchema = z.object({
   emergencyContacts: z.array(emergencyContactSchema).optional(),
 });
 
+/**
+ * Schema for validating patient search parameters.
+ */
+export const searchPatientsSchema = z
+  .object({
+    clinicId: z.string().optional(),
+    practitionerId: z.string().optional(),
+  })
+  .refine((data) => data.clinicId || data.practitionerId, {
+    message: "At least one of clinicId or practitionerId must be provided",
+    path: [], // Optional: specify a path like ['clinicId'] or ['practitionerId']
+  });
+
+/**
+ * Schema for validating requester information during patient search.
+ */
+export const requesterInfoSchema = z
+  .object({
+    id: z.string(),
+    role: z.enum(["clinic_admin", "practitioner"]),
+    associatedClinicId: z.string().optional(),
+    associatedPractitionerId: z.string().optional(),
+  })
+  .refine(
+    (data) => {
+      if (data.role === "clinic_admin") {
+        return !!data.associatedClinicId;
+      } else if (data.role === "practitioner") {
+        return !!data.associatedPractitionerId;
+      }
+      return false;
+    },
+    {
+      message:
+        "Associated ID (clinic or practitioner) is required based on role",
+      path: ["associatedClinicId", "associatedPractitionerId"],
+    }
+  );
+
 export * from "./patient/medical-info.schema";