@omersx/bemms 0.0.0-stage → 0.1.0

package/src/lib/validators/__tests__/users.test.ts

@@ -0,0 +1,92 @@
+import { describe, it, expect } from 'vitest';
+import { updateUserProfileSchema, inviteUserSchema } from '../users';
+
+describe('updateUserProfileSchema', () => {
+  it('validates profile updates with valid clinical title and phone', () => {
+    const result = updateUserProfileSchema.safeParse({
+      fullName: 'Dr. Sarah Al-Mansoor',
+      jobTitle: 'Charge Nurse - Intensive Care Unit',
+      phone: '+966 50 123 4567',
+      employeeIdentifier: 'Ext. 3120 - Bed 4',
+    });
+    expect(result.success).toBe(true);
+  });
+
+  it('accepts partial updates', () => {
+    const result = updateUserProfileSchema.safeParse({
+      phone: '+966 55 987 6543',
+    });
+    expect(result.success).toBe(true);
+  });
+
+  it('rejects fullName that is too short', () => {
+    const result = updateUserProfileSchema.safeParse({
+      fullName: 'A',
+    });
+    expect(result.success).toBe(false);
+  });
+});
+
+describe('inviteUserSchema', () => {
+  it('validates user invitation payload with required fields', () => {
+    const result = inviteUserSchema.safeParse({
+      fullName: 'Nurse Layla',
+      email: 'layla@hospital.org',
+      jobTitle: 'Staff Nurse',
+      organizationId: '123e4567-e89b-12d3-a456-426614174000',
+      roleIds: ['123e4567-e89b-12d3-a456-426614174001'],
+    });
+    expect(result.success).toBe(true);
+  });
+
+  it('validates user invitation payload with optional hospital, department and specialization', () => {
+    const result = inviteUserSchema.safeParse({
+      fullName: 'Eng. Khalid Al-Otaibi',
+      email: 'khalid@hospital.org',
+      jobTitle: 'Senior Biomedical Engineer',
+      organizationId: '123e4567-e89b-12d3-a456-426614174000',
+      roleIds: ['123e4567-e89b-12d3-a456-426614174001'],
+      hospitalId: '123e4567-e89b-12d3-a456-426614174002',
+      departmentId: '123e4567-e89b-12d3-a456-426614174003',
+      specialization: 'ICU & Ventilators',
+    });
+    expect(result.success).toBe(true);
+  });
+
+  it('validates addUser with initial password and dutyStatus', () => {
+    const result = inviteUserSchema.safeParse({
+      fullName: 'Eng. Omar',
+      email: 'omar@hospital.org',
+      organizationId: '123e4567-e89b-12d3-a456-426614174000',
+      roleIds: ['123e4567-e89b-12d3-a456-426614174001'],
+      password: 'SecurePassword123!',
+      dutyStatus: 'on_duty',
+    });
+    expect(result.success).toBe(true);
+  });
+
+  it('validates addUser with explicit username', () => {
+    const result = inviteUserSchema.safeParse({
+      fullName: 'Eng. Omar',
+      email: 'omar@hospital.org',
+      username: 'eng.omar',
+      organizationId: '123e4567-e89b-12d3-a456-426614174000',
+      roleIds: ['123e4567-e89b-12d3-a456-426614174001'],
+      password: 'SecurePassword123!',
+    });
+    expect(result.success).toBe(true);
+  });
+
+  it('rejects password shorter than 6 characters if provided', () => {
+    const result = inviteUserSchema.safeParse({
+      fullName: 'Eng. Omar',
+      email: 'omar@hospital.org',
+      organizationId: '123e4567-e89b-12d3-a456-426614174000',
+      roleIds: ['123e4567-e89b-12d3-a456-426614174001'],
+      password: '123',
+    });
+    expect(result.success).toBe(false);
+  });
+});
+
+

package/src/lib/validators/auth.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+
+export const loginSchema = z.object({
+  email: z.string().min(1, 'Username or email is required'),
+  password: z.string().min(6, 'Password must be at least 6 characters'),
+});
+
+export const registerSchema = loginSchema.extend({
+  fullName: z.string().min(2, 'Full name must be at least 2 characters'),
+  phone: z.string().optional(),
+  jobTitle: z.string().optional(),
+});
+
+export const passwordResetSchema = z.object({
+  email: z.string().email('Invalid email address'),
+});
+
+export const changePasswordSchema = z.object({
+  currentPassword: z.string(),
+  newPassword: z.string()
+    .min(8, 'Password must be at least 8 characters')
+    .regex(/[A-Z]/, 'Password must contain at least one uppercase letter')
+    .regex(/[a-z]/, 'Password must contain at least one lowercase letter')
+    .regex(/[0-9]/, 'Password must contain at least one number')
+    .regex(/[^A-Za-z0-9]/, 'Password must contain at least one special character'),
+});
+
+export type LoginInput = z.infer<typeof loginSchema>;
+export type RegisterInput = z.infer<typeof registerSchema>;
+export type PasswordResetInput = z.infer<typeof passwordResetSchema>;
+export type ChangePasswordInput = z.infer<typeof changePasswordSchema>;
+

package/src/lib/validators/data-management.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+
+export const deviceImportRowSchema = z.object({
+  assetNumber: z.string().min(1, 'Asset number is required').trim(),
+  name: z.string().min(1, 'Device name is required').trim(),
+  model: z.string().optional().default(''),
+  serialNumber: z.string().optional().default(''),
+  categoryName: z.string().min(1, 'Category is required').trim(),
+  manufacturerName: z.string().min(1, 'Manufacturer is required').trim(),
+  departmentName: z.string().min(1, 'Department is required').trim(),
+  locationDescription: z.string().optional().default(''),
+  riskClassification: z.enum(['class_i', 'class_iia', 'class_iib', 'class_iii']).default('class_i'),
+  criticalityLevel: z.enum(['low', 'medium', 'high']).default('medium'),
+  purchaseDate: z.string().optional().default(''),
+  purchaseCost: z.string().optional().default(''),
+  installationDate: z.string().optional().default(''),
+  warrantyStartDate: z.string().optional().default(''),
+  warrantyEndDate: z.string().optional().default(''),
+});
+
+export type DeviceImportRow = z.infer<typeof deviceImportRowSchema>;
+
+export interface DeviceImportValidationResult {
+  rowNumber: number;
+  data: DeviceImportRow;
+  status: 'valid' | 'warning' | 'error';
+  messages: string[];
+  resolvedCategoryId?: string;
+  resolvedManufacturerId?: string;
+  resolvedDepartmentId?: string;
+  willCreateCategory?: boolean;
+  willCreateManufacturer?: boolean;
+}
+
+export const departmentImportRowSchema = z.object({
+  name: z.string().min(1, 'Department name is required').trim(),
+  code: z.string().min(1, 'Department code is required').trim(),
+  departmentType: z.string().optional().default(''),
+  hospitalName: z.string().min(1, 'Hospital name is required').trim(),
+});
+
+export type DepartmentImportRow = z.infer<typeof departmentImportRowSchema>;
+
+export interface DepartmentImportValidationResult {
+  rowNumber: number;
+  data: DepartmentImportRow;
+  status: 'valid' | 'warning' | 'error';
+  messages: string[];
+  resolvedHospitalId?: string;
+}
+
+export const purgeDataSchema = z.object({
+  scope: z.enum(['test_transactions', 'factory_reset']),
+  confirmText: z.string().min(1, 'Confirmation phrase is required'),
+  password: z.string().min(1, 'Admin password is required'),
+  reason: z.string().optional(),
+});
+
+export type PurgeDataPayload = z.infer<typeof purgeDataSchema>;
+
+export const exportRequestSchema = z.object({
+  entities: z.array(z.enum(['devices', 'departments', 'catalogs', 'tickets', 'audit_logs', 'rounds'])).min(1, 'Select at least one entity'),
+  format: z.enum(['csv', 'json', 'xlsx']).default('csv'),
+});
+
+export type ExportRequest = z.infer<typeof exportRequestSchema>;
+

package/src/lib/validators/departments.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+export const createDepartmentSchema = z.object({
+  organizationId: z.string().uuid(),
+  hospitalId: z.string().uuid(),
+  name: z.string().min(2).max(100),
+  code: z.string().min(2).max(20),
+  departmentType: z.string().optional().nullable(),
+  managerUserId: z.string().uuid().optional().nullable().or(z.literal('')),
+  status: z.enum(['active', 'inactive', 'archived']).default('active'),
+});
+
+export const updateDepartmentSchema = createDepartmentSchema.partial().omit({ organizationId: true, hospitalId: true });
+

package/src/lib/validators/devices.ts

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+
+export const createDeviceCategorySchema = z.object({
+  organizationId: z.string().uuid(),
+  name: z.string().min(2).max(100),
+  code: z.string().min(1).max(50),
+  description: z.string().max(500).optional(),
+  riskClassification: z.enum(['class_i', 'class_iia', 'class_iib', 'class_iii']).optional(),
+  criticalityLevel: z.enum(['critical', 'high', 'medium', 'low']).optional(),
+  defaultPmIntervalDays: z.number().int().positive().optional(),
+});
+
+export const updateDeviceCategorySchema = createDeviceCategorySchema.partial().omit({ organizationId: true });
+
+export const createManufacturerSchema = z.object({
+  organizationId: z.string().uuid(),
+  name: z.string().min(2).max(150),
+  code: z.string().max(50).optional(),
+  country: z.string().max(100).optional(),
+  supportEmail: z.string().email().optional().or(z.literal('')),
+  supportPhone: z.string().max(30).optional(),
+  website: z.string().url().optional().or(z.literal('')),
+});
+
+export const updateManufacturerSchema = createManufacturerSchema.partial().omit({ organizationId: true });
+
+export const createDeviceSchema = z.object({
+  organizationId: z.string().uuid(),
+  hospitalId: z.string().uuid(),
+  departmentId: z.string().uuid(),
+  locationId: z.string().uuid().optional(),
+  exactLocationDescription: z.string().max(200).optional(),
+  name: z.string().min(2).max(200),
+  assetNumber: z.string().min(1).max(50),
+  serialNumber: z.string().max(100).optional(),
+  deviceCategoryId: z.string().uuid().optional().or(z.literal('')),
+  manufacturerId: z.string().uuid().optional(),
+  deviceModelId: z.string().uuid().optional(),
+  modelNameFree: z.string().max(200).optional(),
+  criticalityLevel: z.enum(['critical', 'high', 'medium', 'low']).optional(),
+  riskClassification: z.enum(['class_i', 'class_iia', 'class_iib', 'class_iii']).optional(),
+  purchaseDate: z.string().optional(),
+  purchaseCost: z.string().optional(),
+  currency: z.string().max(5).optional(),
+  installationDate: z.string().optional(),
+  commissioningDate: z.string().optional(),
+  warrantyStartDate: z.string().optional(),
+  warrantyEndDate: z.string().optional(),
+  technicalSpecifications: z.any().optional(),
+  assignedEngineerUserId: z.string().uuid().optional(),
+});
+
+export const updateDeviceSchema = createDeviceSchema.partial().omit({ organizationId: true });
+
+export const transferDeviceSchema = z.object({
+  destinationHospitalId: z.string().uuid(),
+  destinationDepartmentId: z.string().uuid(),
+  destinationLocationId: z.string().uuid().optional(),
+  transferReason: z.enum(['relocation', 'temporary_loan', 'department_change', 'correction', 'replacement', 'workshop', 'storage', 'other']),
+  notes: z.string().max(500).optional(),
+});
+
+export const changeDeviceStatusSchema = z.object({
+  newStatusCode: z.enum([
+    'operational', 'operational_with_limitations', 'under_maintenance', 'under_repair',
+    'waiting_for_parts', 'awaiting_release', 'out_of_service', 'standby', 'decommissioned'
+  ]),
+  reason: z.string().min(5).max(500),
+  notes: z.string().max(1000).optional(),
+  limitationsNote: z.string().max(500).optional(),
+  ticketId: z.string().uuid().optional(),
+  maintenanceRecordId: z.string().uuid().optional(),
+});
+
+export const decommissionDeviceSchema = z.object({
+  reason: z.string().min(10).max(500),
+  disposition: z.string().max(200).optional(),
+  technicalApprovalNotes: z.string().max(500).optional(),
+});
+
+export const deviceFilterSchema = z.object({
+  search: z.string().optional(),
+  organizationId: z.string().uuid().optional(),
+  hospitalId: z.string().uuid().optional(),
+  departmentId: z.string().uuid().optional(),
+  locationId: z.string().uuid().optional(),
+  categoryId: z.string().uuid().optional(),
+  manufacturerId: z.string().uuid().optional(),
+  status: z.string().optional(),
+  criticality: z.string().optional(),
+  page: z.number().int().positive().optional(),
+  pageSize: z.number().int().positive().max(100).optional(),
+});
+

package/src/lib/validators/engineer-rounds.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+
+// ── Round Status Values ─────────────────────────────────────────────────────────
+
+export const roundStatusValues = ['scheduled', 'in_progress', 'completed', 'missed', 'cancelled'] as const;
+export type RoundStatus = (typeof roundStatusValues)[number];
+
+export const roundVisitStatusValues = ['pending', 'completed', 'skipped'] as const;
+export type RoundVisitStatus = (typeof roundVisitStatusValues)[number];
+
+export const shiftTypeValues = ['morning', 'evening', 'night'] as const;
+export type ShiftType = (typeof shiftTypeValues)[number];
+
+// ── Start Round ─────────────────────────────────────────────────────────────────
+
+export const startRoundSchema = z.object({
+  hospitalId: z.string().uuid('Invalid hospital ID'),
+  shiftType: z.enum(shiftTypeValues).default('morning'),
+  password: z.string().min(1, 'Password is required for electronic signature'),
+});
+
+// ── Complete Department Visit ────────────────────────────────────────────────────
+
+export const completeDepartmentVisitSchema = z.object({
+  visitId: z.string().uuid('Invalid visit ID'),
+  noteText: z.string().max(2000, 'Note must be under 2000 characters').optional(),
+  deviceMentions: z.array(z.object({
+    deviceId: z.string().uuid(),
+    deviceName: z.string(),
+    internalCode: z.string(),
+  })).optional().default([]),
+});
+
+// ── Add Visit Note ──────────────────────────────────────────────────────────────
+
+export const addVisitNoteSchema = z.object({
+  visitId: z.string().uuid('Invalid visit ID'),
+  noteText: z.string().min(1, 'Note cannot be empty').max(2000, 'Note must be under 2000 characters'),
+  deviceMentions: z.array(z.object({
+    deviceId: z.string().uuid(),
+    deviceName: z.string(),
+    internalCode: z.string(),
+  })).optional().default([]),
+});
+
+// ── Complete Round ──────────────────────────────────────────────────────────────
+
+export const completeRoundSchema = z.object({
+  roundId: z.string().uuid('Invalid round ID'),
+});
+
+// ── Round History Filters ───────────────────────────────────────────────────────
+
+export const roundHistoryFilterSchema = z.object({
+  hospitalId: z.string().uuid().optional(),
+  engineerId: z.string().uuid().optional(),
+  status: z.enum(roundStatusValues).optional(),
+  dateFrom: z.string().optional(), // YYYY-MM-DD
+  dateTo: z.string().optional(),   // YYYY-MM-DD
+  page: z.coerce.number().int().min(1).default(1),
+  pageSize: z.coerce.number().int().min(1).max(100).default(20),
+});
+
+// ── Calendar Data ───────────────────────────────────────────────────────────────
+
+export const roundCalendarQuerySchema = z.object({
+  engineerId: z.string().uuid(),
+  month: z.coerce.number().int().min(1).max(12),
+  year: z.coerce.number().int().min(2020).max(2100),
+});

package/src/lib/validators/hospitals.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+
+export const createHospitalSchema = z.object({
+  organizationId: z.string().uuid('Invalid organization ID'),
+  name: z.string().min(2, 'Name must be at least 2 characters').max(100),
+  code: z.string().min(2, 'Code must be at least 2 characters').max(20),
+  address: z.string().optional().or(z.literal('')),
+  city: z.string().optional().or(z.literal('')),
+  country: z.string().optional().or(z.literal('')),
+  phone: z.string().optional().or(z.literal('')),
+  email: z.string().email('Invalid email address').optional().or(z.literal('')),
+  timezone: z.string().optional().or(z.literal('')),
+  status: z.enum(['active', 'inactive', 'archived']).default('active'),
+});
+
+export const updateHospitalSchema = createHospitalSchema.partial().omit({ organizationId: true });
+

package/src/lib/validators/locations.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+
+export const createLocationSchema = z.object({
+  organizationId: z.string().uuid(),
+  hospitalId: z.string().uuid(),
+  departmentId: z.string().uuid(),
+  parentLocationId: z.string().uuid().optional(),
+  locationType: z.enum(['building', 'floor', 'room', 'area', 'workshop', 'store', 'other']),
+  name: z.string().min(1).max(100),
+  code: z.string().optional(),
+  status: z.enum(['active', 'inactive', 'archived']).default('active'),
+});
+
+export const updateLocationSchema = createLocationSchema.partial().omit({ organizationId: true, hospitalId: true, departmentId: true });
+

package/src/lib/validators/maintenance.ts

@@ -0,0 +1,211 @@
+import { z } from 'zod';
+
+// ── Maintenance Task Validators ──────────────────────────────────────────────
+
+export const createMaintenanceTaskSchema = z.object({
+  organizationId: z.string().uuid(),
+  hospitalId: z.string().uuid(),
+  departmentId: z.string().uuid().optional(),
+  locationId: z.string().uuid().optional(),
+  deviceId: z.string().uuid(),
+  serviceTicketId: z.string().uuid().optional(),
+  maintenanceScheduleOccurrenceId: z.string().uuid().optional(),
+  maintenanceType: z.enum([
+    'preventive_maintenance', 'corrective_maintenance', 'troubleshooting',
+    'inspection', 'calibration', 'electrical_safety_testing',
+    'performance_testing', 'installation_commissioning',
+    'software_configuration', 'decommissioning'
+  ]),
+  technicalProblemCategory: z.enum([
+    'electrical_power', 'display_user_interface', 'alarm_safety',
+    'sensor_measurement', 'mechanical', 'software_configuration',
+    'performance_output', 'accessory_consumable', 'physical_damage',
+    'communication_network', 'no_fault_found', 'other'
+  ]).optional(),
+  title: z.string().min(5).max(200),
+  description: z.string().optional(),
+  assignedEngineerUserId: z.string().uuid().optional(),
+  priorityCode: z.enum(['p1_critical', 'p2_high', 'p3_normal', 'p4_low']).default('p3_normal'),
+  dueDate: z.string().datetime().optional(),
+  checklistTemplateVersionId: z.string().uuid().optional(),
+});
+
+export const assignMaintenanceTaskSchema = z.object({
+  assignedEngineerUserId: z.string().uuid(),
+  handoffNote: z.string().optional(),
+});
+
+export const updateMaintenanceTaskStageSchema = z.object({
+  waitingDependencyType: z.enum(['parts', 'requester', 'vendor', 'department_access']).optional(),
+  waitingReason: z.string().min(5).optional(),
+  resumeNote: z.string().optional(),
+});
+
+export const completeMaintenanceTaskSchema = z.object({
+  diagnosis: z.string().optional(),
+  rootCause: z.string().optional(),
+  workPerformed: z.string().min(10),
+  findings: z.string().optional(),
+  recommendations: z.string().optional(),
+  finalResultCode: z.enum([
+    'passed', 'passed_with_limitations', 'failed', 'no_fault_found',
+    'decommission_recommended', 'requires_external_service'
+  ]),
+  finalDeviceStatusCode: z.enum([
+    'operational', 'operational_with_limitations', 'under_maintenance', 'under_repair',
+    'waiting_for_parts', 'awaiting_release', 'out_of_service', 'standby', 'decommissioned'
+  ]),
+});
+
+export const cancelMaintenanceTaskSchema = z.object({
+  cancellationReason: z.string().min(10),
+});
+
+// ── PM Plan Validators ──────────────────────────────────────────────────────
+
+export const createMaintenancePlanSchema = z.object({
+  organizationId: z.string().uuid(),
+  hospitalId: z.string().uuid(),
+  departmentId: z.string().uuid().optional(),
+  deviceId: z.string().uuid(),
+  planTypeCode: z.enum([
+    'preventive_maintenance', 'corrective_maintenance', 'troubleshooting',
+    'inspection', 'calibration', 'electrical_safety_testing',
+    'performance_testing', 'installation_commissioning',
+    'software_configuration', 'decommissioning'
+  ]).default('preventive_maintenance'),
+  title: z.string().optional(),
+  calculationMethod: z.enum(['fixed_calendar', 'completion_based']).default('fixed_calendar'),
+  frequencyInterval: z.number().int().min(1),
+  frequencyUnit: z.enum(['days', 'weeks', 'months', 'years']),
+  startBaselineDate: z.string().datetime(),
+  leadTimeDays: z.number().int().min(1).default(30),
+  assignedEngineerUserId: z.string().uuid().optional(),
+  checklistTemplateVersionId: z.string().uuid().optional(),
+  instructions: z.string().optional(),
+});
+
+export const updateMaintenancePlanSchema = z.object({
+  title: z.string().optional(),
+  frequencyInterval: z.number().int().min(1).optional(),
+  frequencyUnit: z.enum(['days', 'weeks', 'months', 'years']).optional(),
+  leadTimeDays: z.number().int().min(1).optional(),
+  assignedEngineerUserId: z.string().uuid().optional(),
+  checklistTemplateVersionId: z.string().uuid().optional(),
+  instructions: z.string().optional(),
+  revisionNote: z.string().min(5),
+});
+
+export const deferOccurrenceSchema = z.object({
+  newDueDate: z.string().datetime(),
+  deferralReason: z.string().min(10),
+});
+
+// ── Checklist Validators ────────────────────────────────────────────────────
+
+export const checklistItemSchema = z.object({
+  id: z.string(),
+  label: z.string().min(3),
+  description: z.string().optional(),
+  isRequired: z.boolean().default(true),
+  itemOrder: z.number().int().min(0),
+  inputType: z.enum(['pass_fail', 'measurement', 'text', 'options']),
+  toleranceMin: z.number().optional(),
+  toleranceMax: z.number().optional(),
+  unit: z.string().optional(),
+  options: z.array(z.string()).optional(),
+});
+
+export const createChecklistTemplateSchema = z.object({
+  organizationId: z.string().uuid(),
+  deviceCategoryId: z.string().uuid().optional(),
+  name: z.string().min(3),
+  code: z.string().optional(),
+  maintenanceType: z.enum([
+    'preventive_maintenance', 'corrective_maintenance', 'troubleshooting',
+    'inspection', 'calibration', 'electrical_safety_testing',
+    'performance_testing', 'installation_commissioning',
+    'software_configuration', 'decommissioning'
+  ]).optional(),
+  items: z.array(checklistItemSchema).min(1),
+});
+
+export const createChecklistVersionSchema = z.object({
+  items: z.array(checklistItemSchema).min(1),
+});
+
+export const saveChecklistResultSchema = z.object({
+  templateItemId: z.string(),
+  resultCode: z.enum(['passed', 'failed', 'not_applicable', 'requires_follow_up']).optional(),
+  measuredValue: z.string().optional(),
+  unit: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const saveChecklistProgressSchema = z.object({
+  items: z.array(saveChecklistResultSchema).min(1),
+});
+
+// ── Parts & Costs Validators ────────────────────────────────────────────────
+
+export const maintenancePartSchema = z.object({
+  partNumber: z.string().min(1),
+  partName: z.string().min(1),
+  quantity: z.number().int().min(1).default(1),
+  unitCost: z.number().int().min(0).optional(),
+  currency: z.string().default('USD'),
+  supplierName: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const maintenanceCostSchema = z.object({
+  costType: z.enum(['part', 'vendor_service', 'labor', 'transport', 'other']),
+  amount: z.number().int().min(0),
+  currency: z.string().default('USD'),
+  vendorName: z.string().optional(),
+  invoiceNumber: z.string().optional(),
+  description: z.string().optional(),
+});
+
+// ── Electronic Signature Validators ─────────────────────────────────────────
+
+export const electronicSignatureSchema = z.object({
+  signaturePurpose: z.enum(['perform', 'review', 'release', 'approve', 'reject', 'amend']),
+  authMethod: z.enum(['password_reauth']).default('password_reauth'),
+  password: z.string().min(1),
+  comments: z.string().optional(),
+});
+
+export const reviewWorkSchema = z.object({
+  decision: z.enum(['approve', 'reject']),
+  reviewNotes: z.string().optional(),
+  rejectionReason: z.string().optional(),
+  password: z.string().min(1),
+});
+
+export const releaseDeviceSchema = z.object({
+  finalDeviceStatusCode: z.enum(['operational', 'operational_with_limitations']),
+  releaseNotes: z.string().optional(),
+  password: z.string().min(1),
+});
+
+export const amendRecordSchema = z.object({
+  amendmentReason: z.string().min(10),
+  corrections: z.record(z.string(), z.unknown()),
+  password: z.string().min(1),
+});
+
+// ── Task Filter Schema ──────────────────────────────────────────────────────
+
+export const maintenanceTaskFilterSchema = z.object({
+  search: z.string().optional(),
+  statusCode: z.string().optional(),
+  maintenanceType: z.string().optional(),
+  assignedEngineerUserId: z.string().uuid().optional(),
+  hospitalId: z.string().uuid().optional(),
+  departmentId: z.string().uuid().optional(),
+  deviceId: z.string().uuid().optional(),
+  page: z.number().int().min(1).default(1),
+  pageSize: z.number().int().min(1).max(100).default(20),
+});
+

package/src/lib/validators/organizations.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+
+export const createOrganizationSchema = z.object({
+  name: z.string().min(2).max(100),
+  code: z.string().min(2).max(20).toUpperCase(),
+  defaultTimezone: z.string().default('UTC'),
+  status: z.enum(['active', 'archived']).default('active'),
+});
+
+export const updateOrganizationSchema = createOrganizationSchema.partial();
+

package/src/lib/validators/reports.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+
+export const reportDateRangeSchema = z.object({
+  startDate: z.string().datetime().optional(), // ISO date string
+  endDate: z.string().datetime().optional(),
+  timezone: z.string().default('UTC'),
+});
+
+export const reportFiltersSchema = z.object({
+  organizationId: z.string().uuid().optional(),
+  hospitalId: z.string().uuid().optional(),
+  departmentId: z.string().uuid().optional(),
+  deviceCategoryId: z.string().uuid().optional(),
+  status: z.string().optional(),
+  groupBy: z.enum(['hospital', 'department', 'category', 'status', 'manufacturer', 'priority', 'engineer', 'month', 'maintenance_type']).optional(),
+  startDate: z.string().datetime().optional(),
+  endDate: z.string().datetime().optional(),
+  timezone: z.string().default('UTC'),
+  page: z.number().int().positive().default(1),
+  pageSize: z.number().int().positive().max(100).default(25),
+});
+
+export const inventoryReportFiltersSchema = reportFiltersSchema.extend({});
+export const ticketPerformanceFiltersSchema = reportFiltersSchema.extend({});
+export const maintenanceComplianceFiltersSchema = reportFiltersSchema.extend({});
+export const costReportFiltersSchema = reportFiltersSchema.extend({});
+export const workloadReportFiltersSchema = reportFiltersSchema.extend({});
+export const deviceHistoryFiltersSchema = reportFiltersSchema.extend({
+  deviceId: z.string().uuid().optional(),
+});
+