docta-package 1.0.1

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "docta-package",
+  "version": "1.0.1",
+  "description": "This package will contail all the required files to run the docta micro-service app",
+  "main": "index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "clean": "rm -rf build",
+    "build": "npm run clean && tsc",
+    "prepublishOnly": "npm run build",
+    "release": "npm version patch -m 'Release %s' && npm publish --access public"
+  },
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/bcryptjs": "^2.4.6",
+    "@types/express": "^5.0.3",
+    "@types/jest": "^30.0.0",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^24.7.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.908.0",
+    "@aws-sdk/s3-request-presigner": "^3.908.0",
+    "bcryptjs": "^3.0.2",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "express": "^5.1.0",
+    "mongoose": "^8.19.1",
+    "reflect-metadata": "^0.2.2",
+    "winston": "^3.18.3",
+    "winston-daily-rotate-file": "^5.0.0"
+  }
+}

package/src/config.ts

@@ -0,0 +1,25 @@
+interface GeneralConfig {
+  accessTokenSecret: string;
+  refreshTokenSecret: string;
+  accessTokenExpiry: number;
+  refreshTokenExpiry: number;
+  awsAccessKey: string;
+  awsSecretKey: string;
+  awsS3Bucket: string;
+  awsS3Region: string;
+  forgotPasswordTokenSecret: string;
+  activationTokenSecret: string;
+}
+
+export const generalConfig: GeneralConfig = {
+  accessTokenSecret: String(process.env.ACCESS_TOKEN_SECRET),
+  refreshTokenSecret: String(process.env.REFRESH_TOKEN_SECRET),
+  accessTokenExpiry: Number(process.env.ACCESS_TOKEN_EXPIRY),
+  refreshTokenExpiry: Number(process.env.REFRESH_TOKEN_EXPIRY),
+  awsAccessKey: String(process.env.AWS_ACCESS_KEY),
+  awsSecretKey: String(process.env.AWS_SECRET_KEY),
+  awsS3Bucket: String(process.env.AWS_S3_BUCKET),
+  awsS3Region: String(process.env.AWS_S3_REGION),
+  forgotPasswordTokenSecret: String(process.env.FORGOT_PASSWORD_TOKEN_SECRET),
+  activationTokenSecret: String(process.env.ACTIVATION_TOKEN_SECRET),
+};

package/src/dto/input/doctor.ts

@@ -0,0 +1,120 @@
+import {
+  IsEmail,
+  IsString,
+  MaxLength,
+  MinLength,
+  IsStrongPassword,
+  IsMongoId,
+  IsOptional,
+  IsNumber,
+  Min,
+  IsNotEmpty,
+  IsBoolean,
+  IsArray,
+  ValidateNested,
+  ArrayMaxSize,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { EducationInputDto } from ".";
+import { PositionInputDto } from ".";
+import { LanguageInputDto } from ".";
+import { FaqInputDto } from ".";
+import { LocationInputDto } from ".";
+
+export class CreateDoctorDto {
+  @IsString()
+  @MinLength(3)
+  @MaxLength(50)
+  name: string;
+
+  @IsEmail()
+  email: string;
+
+  @IsMongoId()
+  specialtyId: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  biography?: string;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  consultationFee?: number;
+}
+
+export class ActivateDoctorAccountDto {
+  @IsString()
+  @IsNotEmpty({ message: "Activation token token is required" })
+  token: string;
+
+  @IsString()
+  @MinLength(6)
+  @MaxLength(30)
+  @IsStrongPassword()
+  password: string;
+}
+
+export class UpdateDoctorDto {
+  @IsOptional()
+  @IsString()
+  @MinLength(3)
+  @MaxLength(50)
+  name: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  biography?: string;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  consultationFee?: number;
+
+  @IsOptional()
+  @IsBoolean()
+  isVisible?: boolean;
+
+  // Replace-all educations array
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => EducationInputDto)
+  educations?: EducationInputDto[];
+
+  // Replace-all positions array
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => PositionInputDto)
+  positions?: PositionInputDto[];
+
+  // Replace-all languages array
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => LanguageInputDto)
+  languages?: LanguageInputDto[];
+
+  // Replace-all FAQs array
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => FaqInputDto)
+  faqs?: FaqInputDto[];
+
+  // Replace-all expertises array (array of strings)
+  @IsOptional()
+  @IsArray()
+  @ArrayMaxSize(5, { message: "A maximum of 5 expertises is allowed" })
+  @IsString({ each: true })
+  expertises?: string[];
+
+  // Optional location object (replace-all when provided)
+  @IsOptional()
+  @ValidateNested()
+  @Type(() => LocationInputDto)
+  location?: LocationInputDto;
+}

package/src/dto/input/education.ts

@@ -0,0 +1,11 @@
+import { IsNotEmpty, IsNumber, IsString, Min } from "class-validator";
+
+export class EducationInputDto {
+  @IsNumber({}, { message: "Year must be a number" })
+  @Min(0, { message: "Year must be greater than or equal to 0" })
+  year!: number;
+
+  @IsString({ message: "Title must be a string" })
+  @IsNotEmpty({ message: "Title is required" })
+  title!: string;
+}

package/src/dto/input/faq.ts

@@ -0,0 +1,11 @@
+import { IsNotEmpty, IsString } from "class-validator";
+
+export class FaqInputDto {
+  @IsString({ message: "Title must be a string" })
+  @IsNotEmpty({ message: "Title is required" })
+  title!: string;
+
+  @IsString({ message: "Description must be a string" })
+  @IsNotEmpty({ message: "Description is required" })
+  description!: string;
+}

package/src/dto/input/index.ts

@@ -0,0 +1,9 @@
+export * from "./doctor";
+export * from "./education";
+export * from "./faq";
+export * from "./language";
+export * from "./location";
+export * from "./patient";
+export * from "./position";
+export * from "./specialty";
+export * from "./user";

package/src/dto/input/language.ts

@@ -0,0 +1,13 @@
+import { IsEnum, IsNotEmpty, IsString } from "class-validator";
+import { EnumLanguageLevel } from "../../enums";
+
+export class LanguageInputDto {
+  @IsString({ message: "Title must be a string" })
+  @IsNotEmpty({ message: "Title is required" })
+  title!: string;
+
+  @IsEnum(EnumLanguageLevel, {
+    message: "Level must be a valid language level",
+  })
+  level!: EnumLanguageLevel;
+}

package/src/dto/input/location.ts

@@ -0,0 +1,31 @@
+import { IsNumber, IsOptional, IsString } from "class-validator";
+
+export class LocationInputDto {
+  @IsOptional()
+  @IsString()
+  address?: string;
+
+  @IsOptional()
+  @IsString()
+  city?: string;
+
+  @IsOptional()
+  @IsString()
+  country?: string; // ISO code eg: fr
+
+  @IsOptional()
+  @IsNumber()
+  lat?: number;
+
+  @IsOptional()
+  @IsNumber()
+  lng?: number;
+
+  @IsOptional()
+  @IsString()
+  zipcode?: string;
+
+  @IsOptional()
+  @IsNumber()
+  distanceInMeters?: number | null;
+}

package/src/dto/input/patient.ts

@@ -0,0 +1,17 @@
+import { IsEnum, IsNumber, IsOptional, IsString } from "class-validator";
+import { Gender } from "../../enums";
+
+export class UpdatePatientDto {
+  @IsOptional()
+  @IsString()
+  @IsEnum(Gender)
+  gender?: Gender;
+
+  @IsOptional()
+  @IsString()
+  phoneNumber?: string;
+
+  @IsOptional()
+  @IsNumber()
+  dob?: number;
+}

package/src/dto/input/position.ts

@@ -0,0 +1,21 @@
+import { IsNotEmpty, IsNumber, IsOptional, IsString, Min } from "class-validator";
+
+export class PositionInputDto {
+  @IsNumber({}, { message: "Start date must be a number (timestamp in ms)" })
+  @Min(0, { message: "Start date must be >= 0" })
+  startDate!: number;
+
+  @IsOptional()
+  @IsNumber({}, { message: "End date must be a number (timestamp in ms)" })
+  @Min(0, { message: "End date must be >= 0" })
+  endDate?: number;
+
+  @IsString({ message: "Title must be a string" })
+  @IsNotEmpty({ message: "Title is required" })
+  title!: string;
+
+  @IsString({ message: "Company must be a string" })
+  @IsNotEmpty({ message: "Company is required" })
+  company!: string;
+}
+

package/src/dto/input/specialty.ts

@@ -0,0 +1,40 @@
+import {
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+
+export class LocalizedSpecialtyDto {
+  @IsString()
+  @IsNotEmpty()
+  name!: string;
+
+  @IsOptional()
+  @IsString()
+  description?: string | null;
+}
+
+export class CreateSpecialtyDto {
+  @ValidateNested()
+  @Type(() => LocalizedSpecialtyDto)
+  en!: LocalizedSpecialtyDto;
+
+  @IsOptional()
+  @ValidateNested()
+  @Type(() => LocalizedSpecialtyDto)
+  fr?: LocalizedSpecialtyDto;
+}
+
+export class UpdateSpecialtyDto {
+  @IsOptional()
+  @ValidateNested()
+  @Type(() => LocalizedSpecialtyDto)
+  en?: LocalizedSpecialtyDto;
+
+  @IsOptional()
+  @ValidateNested()
+  @Type(() => LocalizedSpecialtyDto)
+  fr?: LocalizedSpecialtyDto;
+}

package/src/dto/input/user.ts

@@ -0,0 +1,87 @@
+import {
+  IsEmail,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  IsStrongPassword,
+  MaxLength,
+  MinLength,
+} from "class-validator";
+
+export class CreateUserDto {
+  @IsString()
+  @MinLength(3)
+  @MaxLength(50)
+  name: string;
+
+  @IsEmail()
+  email: string;
+
+  @IsString()
+  @MinLength(6)
+  @MaxLength(30)
+  @IsStrongPassword()
+  password: string;
+}
+
+export class LoginDto {
+  @IsEmail({}, { message: "Please enter a valid email address" })
+  @IsNotEmpty({ message: "Email is required" })
+  email: string;
+
+  @IsString({ message: "Password must be a string" })
+  @IsNotEmpty({ message: "Password is required" })
+  password: string;
+}
+
+export class RefreshTokenDto {
+  @IsString({ message: "Refresh token must be a string" })
+  @IsNotEmpty({ message: "Refresh token is required" })
+  refreshToken: string;
+}
+
+export class ActivateAccountDto {
+  @IsString({ message: "Token must be a string" })
+  @IsNotEmpty({ message: "Token is required" })
+  token: string;
+}
+
+export class ForgotPasswordDto {
+  @IsEmail({}, { message: "Please enter a valid email address" })
+  @IsNotEmpty({ message: "Email is required" })
+  email: string;
+}
+
+export class ResetPasswordDto {
+  @IsString({ message: "Token must be a string" })
+  @IsNotEmpty({ message: "Token is required" })
+  token: string;
+
+  @IsString()
+  @MinLength(6)
+  @MaxLength(30)
+  @IsStrongPassword()
+  password: string;
+}
+
+export class UpdateUserDto {
+  @IsOptional()
+  @IsString()
+  @MinLength(3)
+  @MaxLength(50)
+  name: string;
+}
+
+export class UpdatePasswordDto {
+  @IsString()
+  @MinLength(6)
+  @MaxLength(30)
+  @IsStrongPassword()
+  oldPassword: string;
+
+  @IsString()
+  @MinLength(6)
+  @MaxLength(30)
+  @IsStrongPassword()
+  newPassword: string;
+}

package/src/dto/output/doctor.ts

@@ -0,0 +1,90 @@
+import { IDoctorDocument } from "../../models";
+import { SpecialtyOutputDto } from ".";
+import { UserOutputDto } from ".";
+import { EducationOutputDto } from ".";
+import { PositionOutputDto } from ".";
+import { LanguageOutputDto } from ".";
+import { FaqOutputDto } from ".";
+import { LocationOutputDto } from ".";
+
+// Base DTO for everyone
+export class DoctorOutputDto {
+  id: string;
+  user: UserOutputDto;
+  specialty: SpecialtyOutputDto;
+  name: string;
+  biography: string | null;
+  slug: string;
+  isActive: boolean;
+  consultationFee: number | null;
+  isVerified: boolean;
+  isVisible: boolean;
+  photo: string | null;
+  educations: EducationOutputDto[];
+  positions: PositionOutputDto[];
+  languages: LanguageOutputDto[];
+  faqs: FaqOutputDto[];
+  expertises: string[];
+  location: LocationOutputDto | null;
+
+  isDeleted: boolean;
+  createdAt: number;
+  updatedAt: number;
+
+  constructor(doctor: IDoctorDocument) {
+    this.id = doctor.id.toString();
+    this.user = new UserOutputDto(doctor.user);
+    this.name = doctor.name;
+    this.specialty = new SpecialtyOutputDto(doctor.specialty);
+    this.slug = doctor.slug;
+    this.biography = doctor.biography || null;
+    this.isActive = doctor.isActive;
+    this.consultationFee = doctor.consultationFee ?? null;
+    this.isVerified = doctor.isVerified;
+    this.isVisible = doctor.isVisible;
+    this.photo = doctor.photo || null;
+    this.educations = (doctor.educations || [])
+      .map((e) => new EducationOutputDto(e))
+      .sort((a, b) => b.year - a.year);
+    this.positions = (doctor.positions || [])
+      .map((p) => new PositionOutputDto(p))
+      .sort((a, b) => b.startDate - a.startDate);
+    this.languages = (doctor.languages || []).map(
+      (l) => new LanguageOutputDto(l)
+    );
+    this.faqs = (doctor.faqs || []).map((f) => new FaqOutputDto(f));
+    this.expertises = doctor.expertises || [];
+    this.location = doctor.location
+      ? new LocationOutputDto(doctor.location)
+      : null;
+    this.isDeleted = doctor.isDeleted;
+    this.createdAt = doctor.createdAt;
+    this.updatedAt = doctor.updatedAt;
+  }
+}
+
+// Extended DTO for admin responses
+export class DoctorAdminOutputDto extends DoctorOutputDto {
+  isDeactivatedByAdmin: boolean | null;
+  createdBy: UserOutputDto | null;
+  updatedBy: UserOutputDto | null;
+  deletedBy: UserOutputDto | null;
+
+  constructor(doctor: IDoctorDocument) {
+    super(doctor); // call base constructor
+
+    this.isDeactivatedByAdmin = doctor.isDeactivatedByAdmin ?? null;
+
+    this.createdBy = doctor.createdBy
+      ? new UserOutputDto(doctor.createdBy)
+      : null;
+
+    this.updatedBy = doctor.updatedBy
+      ? new UserOutputDto(doctor.updatedBy)
+      : null;
+
+    this.deletedBy = doctor.deletedBy
+      ? new UserOutputDto(doctor.deletedBy)
+      : null;
+  }
+}

package/src/dto/output/education.ts

@@ -0,0 +1,11 @@
+import { IEducation } from "../../models";
+
+export class EducationOutputDto {
+  year: number;
+  title: string;
+
+  constructor(edu: IEducation) {
+    this.year = edu.year;
+    this.title = edu.title;
+  }
+}

package/src/dto/output/faq.ts

@@ -0,0 +1,11 @@
+import { IFaq } from "../../models";
+
+export class FaqOutputDto {
+  title: string;
+  description: string;
+
+  constructor(f: IFaq) {
+    this.title = f.title;
+    this.description = f.description;
+  }
+}

package/src/dto/output/index.ts

@@ -0,0 +1,9 @@
+export * from "./doctor";
+export * from "./education";
+export * from "./faq";
+export * from "./language";
+export * from "./location";
+export * from "./patient";
+export * from "./position";
+export * from "./specialty";
+export * from "./user";

package/src/dto/output/language.ts

@@ -0,0 +1,11 @@
+import { ILanguage } from "../../models";
+
+export class LanguageOutputDto {
+  title: string;
+  level: string;
+
+  constructor(lang: ILanguage) {
+    this.title = lang.title;
+    this.level = lang.level;
+  }
+}

package/src/dto/output/location.ts

@@ -0,0 +1,21 @@
+import { ILocation } from "../../models";
+
+export class LocationOutputDto {
+  address: string | null;
+  city: string | null;
+  country: string | null;
+  lat: number | null;
+  lng: number | null;
+  zipcode: string | null;
+  distanceInMeters: number | null;
+
+  constructor(loc: ILocation) {
+    this.address = loc.address ?? null;
+    this.city = loc.city ?? null;
+    this.country = loc.country ?? null;
+    this.lat = loc.lat ?? null;
+    this.lng = loc.lng ?? null;
+    this.zipcode = loc.zipcode ?? null;
+    this.distanceInMeters = loc.distanceInMeters ?? null;
+  }
+}

package/src/dto/output/patient.ts

@@ -0,0 +1,49 @@
+import { Gender } from "../../enums";
+import { IPatientDocument } from "../../models";
+import { UserOutputDto } from ".";
+
+// Base DTO for everyone
+export class PatientOutputDto {
+  id: string;
+  user: UserOutputDto;
+  dob: number | null;
+  phoneNumber: string | null;
+  gender: Gender | null;
+  isDeleted: boolean;
+  createdAt: number;
+  updatedAt: number;
+
+  constructor(patient: IPatientDocument) {
+    this.id = patient.id.toString();
+    this.user = new UserOutputDto(patient.user);
+    this.dob = patient.dob || null;
+    this.phoneNumber = patient.phoneNumber || null;
+    this.gender = patient.gender || null;
+    this.isDeleted = patient.isDeleted;
+    this.createdAt = patient.createdAt;
+    this.updatedAt = patient.updatedAt;
+  }
+}
+
+// Extended DTO for admin responses
+export class PatientAdminOutputDto extends PatientOutputDto {
+  createdBy: UserOutputDto | null;
+  updatedBy: UserOutputDto | null;
+  deletedBy: UserOutputDto | null;
+
+  constructor(patient: IPatientDocument) {
+    super(patient); // call base constructor
+
+    this.createdBy = patient.createdBy
+      ? new UserOutputDto(patient.createdBy)
+      : null;
+
+    this.updatedBy = patient.updatedBy
+      ? new UserOutputDto(patient.updatedBy)
+      : null;
+
+    this.deletedBy = patient.deletedBy
+      ? new UserOutputDto(patient.deletedBy)
+      : null;
+  }
+}

package/src/dto/output/position.ts

@@ -0,0 +1,15 @@
+import { IPosition } from "../../models";
+
+export class PositionOutputDto {
+  startDate: number;
+  endDate: number | null;
+  title: string;
+  company: string;
+
+  constructor(pos: IPosition) {
+    this.startDate = pos.startDate;
+    this.endDate = pos.endDate ?? null;
+    this.title = pos.title;
+    this.company = pos.company;
+  }
+}