@blackcode_sa/metaestetics-api 1.7.45 → 1.8.0

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

@@ -0,0 +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;
+}

package/src/types/user/index.ts

@@ -0,0 +1,38 @@
+import { User as FirebaseAuthUser } from "firebase/auth";
+import { Timestamp, FieldValue } from "firebase/firestore";
+
+// User tipovi
+export enum UserRole {
+  PATIENT = "patient",
+  PRACTITIONER = "practitioner",
+  APP_ADMIN = "app_admin",
+  CLINIC_ADMIN = "clinic_admin",
+}
+
+export interface User {
+  uid: string;
+  email: string | null;
+  roles: UserRole[];
+  isAnonymous: boolean;
+  createdAt: any;
+  updatedAt: any;
+  lastLoginAt: any;
+  patientProfile?: string;
+  practitionerProfile?: string;
+  adminProfile?: string;
+}
+
+export interface CreateUserData {
+  uid: string;
+  email: string | null;
+  roles: UserRole[];
+  isAnonymous: boolean;
+  createdAt: FieldValue;
+  updatedAt: FieldValue;
+  lastLoginAt: FieldValue;
+}
+
+export const USERS_COLLECTION = "users";
+
+// Firebase tipovi
+export type FirebaseUser = FirebaseAuthUser;

package/src/utils/index.ts

@@ -0,0 +1 @@
+export * from "./TimestampUtils";

package/src/validations/calendar.schema.ts

@@ -14,7 +14,7 @@ import {
 } from "../backoffice/types/static/pricing.types";
 import { clinicLocationSchema } from "./clinic.schema";
 import {
-  clinicInfoSchema,
+  clinicBranchInfoSchema,
   patientProfileInfoSchema,
   practitionerProfileInfoSchema,
 } from "./profile-info.schema";
@@ -108,64 +108,26 @@ export const procedureCategorizationSchema = z.object({
   procedureProduct: z.string(), // Replace with proper enum when available
 });
 
-/**
- * Validation schema for creating an appointment
- */
-export const createAppointmentSchema = z
-  .object({
-    clinicId: z.string().min(1, "Clinic ID is required"),
-    doctorId: z.string().min(1, "Doctor ID is required"),
-    patientId: z.string().min(1, "Patient ID is required"),
-    procedureId: z.string().min(1, "Procedure ID is required"),
-    eventLocation: clinicLocationSchema,
-    eventTime: calendarEventTimeSchema,
-    description: z.string().optional(),
-  })
-  .refine(
-    (data) => {
-      // If we have access to the actual data, we could validate:
-      // - Doctor works at the clinic
-      // - Procedure is available at the clinic
-      // - Patient is eligible for the procedure
-      // These validations will be handled in the service layer
-      return true;
-    },
-    {
-      message: "Invalid appointment parameters",
-    }
-  );
-
-/**
- * Validation schema for updating an appointment
- */
-export const updateAppointmentSchema = z.object({
-  appointmentId: z.string().min(1, "Appointment ID is required"),
-  clinicId: z.string().min(1, "Clinic ID is required"),
-  doctorId: z.string().min(1, "Doctor ID is required"),
-  patientId: z.string().min(1, "Patient ID is required"),
-  eventTime: calendarEventTimeSchema.optional(),
-  description: z.string().optional(),
-  status: z.nativeEnum(CalendarEventStatus).optional(),
-});
-
 /**
  * Validation schema for creating a calendar event
  */
 export const createCalendarEventSchema = z.object({
   id: z.string(),
   clinicBranchId: z.string().nullable().optional(),
-  clinicBranchInfo: z.any().nullable().optional(),
+  clinicBranchInfo: clinicBranchInfoSchema.nullable().optional(),
   practitionerProfileId: z.string().nullable().optional(),
   practitionerProfileInfo: practitionerProfileInfoSchema.nullable().optional(),
   patientProfileId: z.string().nullable().optional(),
   patientProfileInfo: patientProfileInfoSchema.nullable().optional(),
   procedureId: z.string().nullable().optional(),
+  procedureInfo: procedureInfoSchema.nullable().optional(),
+  procedureCategorization: procedureCategorizationSchema.nullable().optional(),
   appointmentId: z.string().nullable().optional(),
   syncedCalendarEventId: z
     .array(syncedCalendarEventSchema)
     .nullable()
     .optional(),
-  eventName: z.string().min(1, "Event name is required"),
+  eventName: z.string(),
   eventLocation: clinicLocationSchema.optional(),
   eventTime: calendarEventTimeSchema,
   description: z.string().optional(),
@@ -200,7 +162,7 @@ export const updateCalendarEventSchema = z.object({
 export const calendarEventSchema = z.object({
   id: z.string(),
   clinicBranchId: z.string().nullable().optional(),
-  clinicBranchInfo: z.any().nullable().optional(), // Will be replaced with proper clinic info schema
+  clinicBranchInfo: clinicBranchInfoSchema.nullable().optional(), // Will be replaced with proper clinic info schema
   practitionerProfileId: z.string().nullable().optional(),
   practitionerProfileInfo: practitionerProfileInfoSchema.nullable().optional(),
   patientProfileId: z.string().nullable().optional(),
@@ -260,5 +222,4 @@ export const updateBlockingEventSchema = z.object({
     .optional(),
   eventTime: calendarEventTimeSchema.optional(),
   description: z.string().max(1000, "Description too long").optional(),
-  status: z.nativeEnum(CalendarEventStatus).optional(),
 });

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

@@ -0,0 +1 @@
+export * from "./template.schema";

package/src/validations/documentation-templates.schema.ts

@@ -7,4 +7,4 @@
 // documentTemplateSchema, createDocumentTemplateSchema, updateDocumentTemplateSchema,
 // filledDocumentSchema, createFilledDocumentDataSchema, updateFilledDocumentDataSchema etc.,
 // are defined and exported from './documentation-templates/template.schema.ts'
-export * from "./documentation-templates/template.schema";
+export * from "./documentation-templates/";

package/src/validations/index.ts

@@ -0,0 +1,20 @@
+// This barrel file consolidates all Zod validation schemas for easy importing.
+
+export * from "./appointment.schema";
+export * from "./calendar.schema";
+export * from "./clinic.schema";
+export * from "./common.schema";
+export * from "./documentation-templates.schema";
+export * from "./media.schema";
+export * from "./notification.schema";
+export * from "./patient.schema";
+export * from "./patient/medical-info.schema";
+export * from "./patient/patient-requirements.schema";
+export * from "./patient/medical-info.schema";
+export * from "./patient/token.schema";
+export * from "./practitioner.schema";
+export * from "./procedure.schema";
+export * from "./profile-info.schema";
+export * from "./reviews.schema";
+export * from "./schemas";
+export * from "./shared.schema";

package/src/validations/patient/token.schema.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { PatientTokenStatus } from "../../types/patient/token.types";
+
+/**
+ * @description Zod schema for validating a PatientToken object.
+ */
+export const patientTokenSchema = z.object({
+  id: z.string().min(1, "Token ID is required"),
+  token: z.string().min(1, "Token string is required"),
+  patientId: z.string().min(1, "Patient ID is required"),
+  email: z.string().email("Invalid email format"),
+  clinicId: z.string().min(1, "Clinic ID is required"),
+  status: z.nativeEnum(PatientTokenStatus),
+  createdBy: z.string().min(1, "Creator ID is required"),
+  createdAt: z.any(), // Assuming Timestamp validated elsewhere
+  expiresAt: z.any(), // Assuming Timestamp validated elsewhere
+  usedBy: z.string().optional(),
+  usedAt: z.any().optional(), // Assuming Timestamp validated elsewhere
+});
+
+/**
+ * @description Zod schema for validating the data required to create a PatientToken.
+ */
+export const createPatientTokenSchema = z.object({
+  patientId: z.string().min(1, "Patient ID is required"),
+  clinicId: z.string().min(1, "Clinic ID is required"),
+  email: z.string().email("Invalid email format"),
+  expiresAt: z.date().optional(),
+});

package/src/validations/patient.schema.ts

@@ -45,7 +45,7 @@ export const gamificationSchema = z.object({
  */
 export const patientLocationInfoSchema = z.object({
   patientId: z.string(),
-  userRef: z.string(),
+  userRef: z.string().optional(),
   locationData: locationDataSchema,
   createdAt: z.instanceof(Timestamp),
   updatedAt: z.instanceof(Timestamp),
@@ -56,7 +56,7 @@ export const patientLocationInfoSchema = z.object({
  */
 export const createPatientLocationInfoSchema = z.object({
   patientId: z.string(),
-  userRef: z.string(),
+  userRef: z.string().optional(),
   locationData: locationDataSchema,
 });
 
@@ -65,7 +65,7 @@ export const createPatientLocationInfoSchema = z.object({
  */
 export const patientSensitiveInfoSchema = z.object({
   patientId: z.string(),
-  userRef: z.string(),
+  userRef: z.string().optional(),
   photoUrl: z.string().nullable().optional(),
   firstName: z.string().min(2),
   lastName: z.string().min(2),
@@ -107,12 +107,13 @@ export const patientClinicSchema = z.object({
  */
 export const patientProfileSchema = z.object({
   id: z.string(),
-  userRef: z.string(),
+  userRef: z.string().optional(),
   displayName: z.string(),
   gamification: gamificationSchema,
   expoTokens: z.array(z.string()),
   isActive: z.boolean(),
   isVerified: z.boolean(),
+  isManual: z.boolean().default(false), // Default to false if missing
   phoneNumber: z.string().nullable().optional(),
   dateOfBirth: z.instanceof(Timestamp).nullable().optional(),
   doctors: z.array(patientDoctorSchema),
@@ -127,12 +128,13 @@ export const patientProfileSchema = z.object({
  * Šema za validaciju podataka pri kreiranju profila
  */
 export const createPatientProfileSchema = z.object({
-  userRef: z.string(),
+  userRef: z.string().optional(),
   displayName: z.string(),
   expoTokens: z.array(z.string()),
   gamification: gamificationSchema.optional(),
   isActive: z.boolean(),
   isVerified: z.boolean(),
+  isManual: z.boolean().default(false),
   doctors: z.array(patientDoctorSchema).optional(),
   clinics: z.array(patientClinicSchema).optional(),
   doctorIds: z.array(z.string()).optional(),
@@ -144,7 +146,7 @@ export const createPatientProfileSchema = z.object({
  */
 export const createPatientSensitiveInfoSchema = z.object({
   patientId: z.string(),
-  userRef: z.string(),
+  userRef: z.string().optional(),
   photoUrl: mediaResourceSchema.nullable().optional(),
   firstName: z.string().min(2),
   lastName: z.string().min(2),
@@ -157,6 +159,21 @@ export const createPatientSensitiveInfoSchema = z.object({
   emergencyContacts: z.array(emergencyContactSchema).optional(),
 });
 
+/**
+ * Schema for validating the data when a clinic admin manually creates a patient.
+ */
+export const createManualPatientSchema = z.object({
+  clinicId: z.string().min(1, "Clinic ID is required"),
+  firstName: z.string().min(2, "First name is required"),
+  lastName: z.string().min(2, "Last name is required"),
+  dateOfBirth: z.instanceof(Timestamp).nullable(),
+  gender: z.nativeEnum(Gender),
+  phoneNumber: z.string().optional(),
+  email: z.string().email().optional(),
+  addressData: addressDataSchema.optional(),
+  notes: z.string().optional(),
+});
+
 /**
  * Schema for validating patient search parameters.
  */

package/src/validations/profile-info.schema.ts

@@ -7,7 +7,7 @@ import { Gender } from "../types/patient";
 /**
  * Validation schema for clinic info
  */
-export const clinicInfoSchema = z.object({
+export const clinicBranchInfoSchema = z.object({
   id: z.string(),
   featuredPhoto: z.string(),
   name: z.string(),

package/src/validations/schemas.ts

@@ -24,33 +24,33 @@ export const userRolesSchema = z
   .min(1, "User must have at least one role")
   .max(3, "User cannot have more than 3 roles");
 
-export const timestampSchema = z.custom<Timestamp | FieldValue | Date>(
-  (data) => {
-    // If it's a serverTimestamp (FieldValue), it's valid
-    if (data && typeof data === "object" && "isEqual" in data) {
-      return true;
-    }
+// export const timestampSchema = z.custom<Timestamp | FieldValue | Date>(
+//   (data) => {
+//     // If it's a serverTimestamp (FieldValue), it's valid
+//     if (data && typeof data === "object" && "isEqual" in data) {
+//       return true;
+//     }
 
-    // If it's a Timestamp object, validate its structure
-    if (
-      data &&
-      typeof data === "object" &&
-      "toDate" in data &&
-      "seconds" in data &&
-      "nanoseconds" in data
-    ) {
-      return true;
-    }
+//     // If it's a Timestamp object, validate its structure
+//     if (
+//       data &&
+//       typeof data === "object" &&
+//       "toDate" in data &&
+//       "seconds" in data &&
+//       "nanoseconds" in data
+//     ) {
+//       return true;
+//     }
 
-    // If it's a JavaScript Date object (what Firestore returns on client), it's valid
-    if (data instanceof Date) {
-      return true;
-    }
+//     // If it's a JavaScript Date object (what Firestore returns on client), it's valid
+//     if (data instanceof Date) {
+//       return true;
+//     }
 
-    return false;
-  },
-  "Must be a Timestamp object, Date object, or serverTimestamp"
-);
+//     return false;
+//   },
+//   "Must be a Timestamp object, Date object, or serverTimestamp"
+// );
 
 /**
  * Validaciona šema za clinic admin opcije pri kreiranju