@blackcode_sa/metaestetics-api 1.15.16 → 1.15.17

package/src/types/procedure/index.ts

@@ -21,6 +21,7 @@ import {
 } from "../../backoffice/types/static/pricing.types";
 import { MediaResource } from "../../services/media/media.service";
 import type { ProcedureProduct } from "../../backoffice/types/procedure-product.types";
+import type { ResourceRequirement } from "../resource";
 
 /**
  * Procedure represents a specific medical procedure that can be performed by a practitioner in a clinic
@@ -84,6 +85,8 @@ export interface Procedure {
   doctorInfo: DoctorInfo;
   /** Aggregated review information for this procedure */
   reviewInfo: ProcedureReviewInfo;
+  /** Optional resources required for this procedure (e.g., surgery room, device) */
+  resourceRequirements?: ResourceRequirement[];
   /** Whether this procedure is active */
   isActive: boolean;
   /** When this procedure was created */
@@ -119,6 +122,7 @@ export interface CreateProcedureData {
   practitionerId: string;
   clinicBranchId: string;
   photos?: MediaResource[];
+  resourceRequirements?: ResourceRequirement[];
 }
 
 /**
@@ -148,6 +152,7 @@ export interface UpdateProcedureData {
   productId?: string;
   clinicBranchId?: string;
   photos?: MediaResource[];
+  resourceRequirements?: ResourceRequirement[];
 }
 
 /**
@@ -180,4 +185,5 @@ export interface ProcedureSummaryInfo {
   clinicName: string;
   practitionerId: string;
   practitionerName: string;
+  resourceRequirements?: ResourceRequirement[];
 }

package/src/types/resource/README.md

@@ -0,0 +1,153 @@
+# Resource Types (`Api/src/types/resource/`)
+
+Type definitions for the Clinic Resources system. These types are used across the API package, Cloud Functions, and the ClinicApp frontend (via the `@blackcode_sa/metaestetics-api` package).
+
+## File: `index.ts`
+
+### Collection Constants
+
+| Constant | Value | Description |
+|----------|-------|-------------|
+| `RESOURCES_COLLECTION` | `"resources"` | Subcollection under clinics |
+| `RESOURCE_INSTANCES_SUBCOLLECTION` | `"instances"` | Subcollection under resources |
+| `RESOURCE_CALENDAR_SUBCOLLECTION` | `"calendar"` | Subcollection under instances |
+
+### Firestore Path
+
+```
+clinics/{clinicId}/resources/{resourceId}
+clinics/{clinicId}/resources/{resourceId}/instances/{instanceId}
+clinics/{clinicId}/resources/{resourceId}/instances/{instanceId}/calendar/{eventId}
+```
+
+### Enums
+
+#### `ResourceCategory`
+Categorizes the type of physical resource.
+
+| Value | Description |
+|-------|-------------|
+| `MEDICAL_DEVICE` | Medical equipment (e.g., laser machine) |
+| `ROOM` | General room (e.g., consultation room) |
+| `SURGERY_SUITE` | Operating/surgery room |
+| `EQUIPMENT` | General equipment |
+| `OTHER` | Uncategorized |
+
+#### `ResourceStatus`
+Tracks the operational state of a resource or instance.
+
+| Value | Description |
+|-------|-------------|
+| `ACTIVE` | Available for booking |
+| `INACTIVE` | Soft-deleted or disabled |
+| `MAINTENANCE` | Temporarily unavailable |
+
+### Interfaces
+
+#### `Resource`
+The main resource definition owned by a clinic branch.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Unique identifier |
+| `clinicBranchId` | `string` | Owning clinic branch |
+| `name` | `string` | Display name |
+| `nameLower` | `string` | Lowercase for case-insensitive search |
+| `category` | `ResourceCategory` | Type of resource |
+| `description` | `string?` | Optional description |
+| `quantity` | `number` | Number of physical instances |
+| `status` | `ResourceStatus` | Current status |
+| `linkedProcedureIds` | `string[]` | Procedures requiring this resource |
+| `createdAt` | `Timestamp` | Creation timestamp |
+| `updatedAt` | `Timestamp` | Last update timestamp |
+
+#### `ResourceInstance`
+A single physical unit of a resource. Each instance has its own calendar.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Unique identifier |
+| `resourceId` | `string` | Parent resource ID |
+| `clinicBranchId` | `string` | Owning clinic branch |
+| `label` | `string` | Auto-generated: `"{Resource.name} #{index}"` |
+| `index` | `number` | 1-based index |
+| `status` | `ResourceStatus` | Current status |
+| `createdAt` / `updatedAt` | `Timestamp` | Timestamps |
+
+#### `ResourceCalendarEvent`
+A calendar event on a resource instance. Can be a booking event (auto-created during appointment creation) or a blocking event (manually created by admin for maintenance/downtime).
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Unique identifier |
+| `resourceId` | `string` | Parent resource |
+| `resourceInstanceId` | `string` | Specific instance |
+| `clinicBranchId` | `string` | Clinic branch |
+| `eventType` | `CalendarEventType` | `RESOURCE_BOOKING` for bookings, `BLOCKING` for manual blocks |
+| `appointmentId` | `string?` | Linked appointment (only for booking events) |
+| `procedureId` | `string?` | Procedure requiring this resource (only for booking events) |
+| `practitionerId` | `string?` | Practitioner performing procedure (only for booking events) |
+| `patientId` | `string?` | Patient for the appointment (only for booking events) |
+| `eventTime` | `CalendarEventTime` | Start and end times |
+| `status` | `CalendarEventStatus` | `CONFIRMED` for blocking events, mirrors appointment status for bookings |
+| `eventName` | `string` | Display name |
+| `description` | `string?` | Optional description (primarily for blocking events) |
+| `createdAt` / `updatedAt` | `Timestamp` | Timestamps |
+
+#### `ResourceRequirement`
+Lightweight reference stored on procedures.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `resourceId` | `string` | ID of the required resource |
+| `resourceName` | `string` | Snapshot of resource name |
+| `resourceCategory` | `ResourceCategory` | Snapshot of category |
+
+#### `ResourceBookingInfo`
+Stored on the appointment after resource allocation.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `resourceId` | `string` | Booked resource |
+| `resourceName` | `string` | Resource name snapshot |
+| `resourceInstanceId` | `string` | Allocated instance |
+| `resourceInstanceLabel` | `string` | Instance label (e.g., "Room #2") |
+| `calendarEventId` | `string` | Calendar event on instance |
+
+#### `CreateResourceData` / `UpdateResourceData`
+Input types for resource CRUD operations. See source for field details.
+
+#### `CreateResourceBlockingEventParams`
+Parameters for creating a blocking event on a resource instance.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `clinicBranchId` | `string` | Clinic branch |
+| `resourceId` | `string` | Parent resource |
+| `resourceInstanceId` | `string` | Target instance |
+| `eventName` | `string` | Display name (e.g., "Maintenance") |
+| `eventTime` | `CalendarEventTime` | Block start and end times |
+| `description` | `string?` | Optional reason for the block |
+
+#### `UpdateResourceBlockingEventParams`
+Parameters for updating an existing blocking event. Only provided fields are updated.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `clinicBranchId` | `string` | Clinic branch |
+| `resourceId` | `string` | Parent resource |
+| `resourceInstanceId` | `string` | Target instance |
+| `eventId` | `string` | ID of the event to update |
+| `eventName` | `string?` | New display name |
+| `eventTime` | `CalendarEventTime?` | New time range |
+| `description` | `string?` | New description |
+
+### Related Type Extensions
+
+This system also extends existing types:
+
+- **`Procedure`** (`types/procedure/index.ts`): Added optional `resourceRequirements?: ResourceRequirement[]`
+- **`Appointment`** (`types/appointment/index.ts`): Added optional `resourceBookings?: ResourceBookingInfo[]`
+- **`CalendarEventType`** (`types/calendar/index.ts`): Added `RESOURCE_BOOKING = "resource_booking"`
+
+See [main Resource System README](../../../docs/RESOURCE_SYSTEM.md) for the full system overview.

package/src/types/resource/index.ts

@@ -0,0 +1,199 @@
+import { Timestamp, FieldValue } from "firebase/firestore";
+import type { CalendarEventTime, CalendarEventStatus } from "../calendar";
+import { CalendarEventType } from "../calendar";
+
+/**
+ * Firestore collection/subcollection names for the resource system
+ */
+export const RESOURCES_COLLECTION = "resources";
+export const RESOURCE_INSTANCES_SUBCOLLECTION = "instances";
+export const RESOURCE_CALENDAR_SUBCOLLECTION = "calendar";
+
+/**
+ * Category of a clinic resource
+ */
+export enum ResourceCategory {
+  MEDICAL_DEVICE = "medical_device",
+  ROOM = "room",
+  SURGERY_SUITE = "surgery_suite",
+  EQUIPMENT = "equipment",
+  OTHER = "other",
+}
+
+/**
+ * Status of a resource or resource instance
+ */
+export enum ResourceStatus {
+  ACTIVE = "active",
+  INACTIVE = "inactive",
+  MAINTENANCE = "maintenance",
+}
+
+/**
+ * A resource definition owned by a clinic branch.
+ * Stored at: clinics/{clinicId}/resources/{resourceId}
+ */
+export interface Resource {
+  /** Unique identifier */
+  id: string;
+  /** Clinic branch this resource belongs to */
+  clinicBranchId: string;
+  /** Display name of the resource */
+  name: string;
+  /** Lowercase name for case-insensitive search */
+  nameLower: string;
+  /** Category of the resource */
+  category: ResourceCategory;
+  /** Optional description */
+  description?: string;
+  /** Number of physical instances (e.g., 3 surgery rooms) */
+  quantity: number;
+  /** Current status */
+  status: ResourceStatus;
+  /** IDs of procedures that require this resource (denormalized for quick lookup) */
+  linkedProcedureIds: string[];
+  createdAt: Timestamp;
+  updatedAt: Timestamp;
+}
+
+/**
+ * A single physical instance of a resource (e.g., "Surgery Room #2").
+ * Each instance has its own calendar for tracking bookings.
+ * Stored at: clinics/{clinicId}/resources/{resourceId}/instances/{instanceId}
+ */
+export interface ResourceInstance {
+  /** Unique identifier */
+  id: string;
+  /** Parent resource ID */
+  resourceId: string;
+  /** Clinic branch this instance belongs to */
+  clinicBranchId: string;
+  /** Display label, auto-generated: "{Resource.name} #{index}" */
+  label: string;
+  /** 1-based index among instances of the same resource */
+  index: number;
+  /** Current status */
+  status: ResourceStatus;
+  createdAt: Timestamp;
+  updatedAt: Timestamp;
+}
+
+/**
+ * Calendar event on a resource instance.
+ * Can be either a booking event (created during appointment creation) or a blocking event (created manually by admin).
+ * Stored at: clinics/{clinicId}/resources/{resourceId}/instances/{instanceId}/calendar/{eventId}
+ */
+export interface ResourceCalendarEvent {
+  /** Unique identifier */
+  id: string;
+  /** Parent resource ID */
+  resourceId: string;
+  /** Instance this event is on */
+  resourceInstanceId: string;
+  /** Clinic branch */
+  clinicBranchId: string;
+  /** Type of event — RESOURCE_BOOKING for appointment bookings, BLOCKING for manual blocks */
+  eventType: CalendarEventType;
+  /** Appointment that booked this resource (only for RESOURCE_BOOKING events) */
+  appointmentId?: string;
+  /** Procedure requiring this resource (only for RESOURCE_BOOKING events) */
+  procedureId?: string;
+  /** Practitioner performing the procedure (only for RESOURCE_BOOKING events) */
+  practitionerId?: string;
+  /** Patient for the appointment (only for RESOURCE_BOOKING events) */
+  patientId?: string;
+  /** Time range of the event */
+  eventTime: CalendarEventTime;
+  /** Event status — CONFIRMED for blocking events, mirrors appointment status for bookings */
+  status: CalendarEventStatus;
+  /** Display name for the event */
+  eventName: string;
+  /** Optional description (primarily for blocking events, e.g., reason for maintenance) */
+  description?: string;
+  createdAt: Timestamp;
+  updatedAt: Timestamp;
+}
+
+/**
+ * Lightweight reference stored on procedures to indicate which resources are required.
+ * Denormalized snapshot of resource info at the time of linking.
+ */
+export interface ResourceRequirement {
+  /** ID of the required resource */
+  resourceId: string;
+  /** Name of the resource (snapshot) */
+  resourceName: string;
+  /** Category of the resource (snapshot) */
+  resourceCategory: ResourceCategory;
+}
+
+/**
+ * Info about a specific resource instance booking, stored on the appointment
+ * after a resource has been allocated during appointment creation.
+ */
+export interface ResourceBookingInfo {
+  /** ID of the booked resource */
+  resourceId: string;
+  /** Name of the resource (snapshot) */
+  resourceName: string;
+  /** ID of the specific instance that was allocated */
+  resourceInstanceId: string;
+  /** Label of the instance (e.g., "Surgery Room #2") */
+  resourceInstanceLabel: string;
+  /** ID of the calendar event created on the instance */
+  calendarEventId: string;
+}
+
+/**
+ * Data required to create a new resource
+ */
+export interface CreateResourceData {
+  clinicBranchId: string;
+  name: string;
+  category: ResourceCategory;
+  description?: string;
+  quantity: number;
+}
+
+/**
+ * Data allowed for updating an existing resource
+ */
+export interface UpdateResourceData {
+  name?: string;
+  category?: ResourceCategory;
+  description?: string;
+  /** Changing quantity: increase creates new instances, decrease is blocked if instances have future bookings */
+  quantity?: number;
+  status?: ResourceStatus;
+}
+
+/**
+ * Parameters for creating a blocking event on a resource instance.
+ * Used to mark an instance as unavailable for a time period (maintenance, out of order, etc.).
+ */
+export interface CreateResourceBlockingEventParams {
+  clinicBranchId: string;
+  resourceId: string;
+  resourceInstanceId: string;
+  /** Display name for the blocking event (e.g., "Maintenance", "Out of Order") */
+  eventName: string;
+  /** Time range during which the instance is blocked */
+  eventTime: CalendarEventTime;
+  /** Optional reason/description for the block */
+  description?: string;
+}
+
+/**
+ * Parameters for updating an existing blocking event on a resource instance.
+ * Only provided fields are updated.
+ */
+export interface UpdateResourceBlockingEventParams {
+  clinicBranchId: string;
+  resourceId: string;
+  resourceInstanceId: string;
+  /** ID of the blocking event to update */
+  eventId: string;
+  eventName?: string;
+  eventTime?: CalendarEventTime;
+  description?: string;
+}

package/src/types/system/index.ts

@@ -0,0 +1 @@
+export * from './planConfig.types';

package/src/types/system/planConfig.types.ts

@@ -0,0 +1,86 @@
+/**
+ * Dynamic Plan Configuration — stored in Firestore at `system/planConfig`.
+ * Editable from the admin dashboard. Hardcoded defaults in tiers.config.ts
+ * serve as fallback when the Firestore document doesn't exist.
+ */
+
+export interface TierDefinition {
+  name: string;
+  limits: {
+    maxProvidersPerBranch: number;
+    maxProceduresPerProvider: number;
+    maxBranches: number;
+  };
+}
+
+export interface PlanDefinition {
+  /** Stripe price ID. null for the free plan. */
+  priceId: string | null;
+  /** Monthly price in the plan currency (e.g. 199 for CHF 199). */
+  priceMonthly: number;
+  currency: string;
+  description: string;
+  /** Stripe product ID — needed when auto-creating new prices. */
+  stripeProductId?: string | null;
+}
+
+export interface SeatAddonDefinition {
+  priceId: string;
+  pricePerUnit: number;
+  currency: string;
+  allowedTiers: string[];
+}
+
+export interface BranchAddonTierPrice {
+  priceId: string;
+  pricePerUnit: number;
+  currency: string;
+}
+
+export interface BranchAddonDefinition {
+  connect: BranchAddonTierPrice;
+  pro: BranchAddonTierPrice;
+  allowedTiers: string[];
+}
+
+export interface ProcedureAddonDefinition {
+  priceId: string;
+  pricePerBlock: number;
+  proceduresPerBlock: number;
+  currency: string;
+  allowedTiers: string[];
+}
+
+export interface PlanConfigDocument {
+  version: number;
+  updatedAt: any; // Firestore Timestamp (any to avoid SDK coupling)
+  updatedBy: string;
+
+  /** Tier definitions with usage limits. Keys: 'free', 'connect', 'pro'. */
+  tiers: Record<string, TierDefinition>;
+
+  /** Plan pricing and Stripe config. Keys: 'FREE', 'CONNECT', 'PRO'. */
+  plans: Record<string, PlanDefinition>;
+
+  /** Add-on pricing and Stripe config. */
+  addons: {
+    seat: SeatAddonDefinition;
+    branch: BranchAddonDefinition;
+    procedure: ProcedureAddonDefinition;
+  };
+
+  /** Auto-computed: maps Stripe priceId → Firestore subscriptionModel ('connect'/'pro'). */
+  priceToModel: Record<string, string>;
+
+  /** Auto-computed: maps Stripe priceId → plan type label ('CONNECT'/'PRO'). */
+  priceToType: Record<string, string>;
+
+  /** Auto-computed: all add-on price IDs for webhook filtering. */
+  addonPriceIds: string[];
+}
+
+/** Firestore path for the plan config document. */
+export const PLAN_CONFIG_PATH = 'system/planConfig';
+
+/** Firestore subcollection path for version history. */
+export const PLAN_CONFIG_HISTORY_PATH = 'system/planConfig/history';

package/src/validations/README.md

@@ -0,0 +1,94 @@
+# Validation Schemas (`Api/src/validations/`)
+
+Zod validation schemas for API input validation. Each schema file corresponds to a domain entity.
+
+## Files
+
+| File | Domain | Description |
+|------|--------|-------------|
+| `appointment.schema.ts` | Appointments | Create/update appointment validation |
+| `calendar.schema.ts` | Calendar | Calendar event validation |
+| `clinic.schema.ts` | Clinics | Clinic CRUD validation |
+| `common.schema.ts` | Shared | Common reusable schemas |
+| `media.schema.ts` | Media | File upload validation |
+| `notification.schema.ts` | Notifications | Notification payload validation |
+| `patient.schema.ts` | Patients | Patient profile validation |
+| `practitioner.schema.ts` | Practitioners | Practitioner profile validation |
+| `procedure.schema.ts` | Procedures | Procedure CRUD validation |
+| `procedure-product.schema.ts` | Products | Procedure product pricing validation |
+| `profile-info.schema.ts` | Profiles | Shared profile info validation |
+| **`resource.schema.ts`** | **Resources** | **Resource CRUD + blocking event validation** |
+| `reviews.schema.ts` | Reviews | Patient review validation |
+| `shared.schema.ts` | Shared | Cross-domain shared schemas |
+
+## Resource Validation (`resource.schema.ts`)
+
+Part of the [Clinic Resources System](../../../docs/RESOURCE_SYSTEM.md).
+
+### `createResourceSchema`
+
+Validates input for creating a new resource.
+
+```typescript
+{
+  clinicBranchId: z.string().min(1),     // Required clinic branch ID
+  name: z.string().min(1).max(200),      // Resource name (1-200 chars)
+  category: z.nativeEnum(ResourceCategory), // Must be valid ResourceCategory
+  description: z.string().max(1000).optional(), // Optional description
+  quantity: z.number().int().min(1).max(100),    // 1-100 instances
+}
+```
+
+### `updateResourceSchema`
+
+Validates input for updating an existing resource. All fields are optional.
+
+```typescript
+{
+  name: z.string().min(1).max(200).optional(),
+  category: z.nativeEnum(ResourceCategory).optional(),
+  description: z.string().max(1000).optional(),
+  quantity: z.number().int().min(1).max(100).optional(),
+  status: z.nativeEnum(ResourceStatus).optional(),
+}
+```
+
+**Note on quantity updates:** Validation only ensures the value is within range. The business logic for quantity decrease (checking for active bookings on affected instances) is handled by `ResourceService.updateResource()`.
+
+### `createResourceBlockingEventSchema`
+
+Validates input for creating a blocking event on a resource instance.
+
+```typescript
+{
+  clinicBranchId: z.string().min(1),
+  resourceId: z.string().min(1),
+  resourceInstanceId: z.string().min(1),
+  eventName: z.string().min(1).max(200),      // Event name (1-200 chars)
+  eventTime: z.object({
+    start: z.any(),                            // Firestore Timestamp
+    end: z.any(),                              // Firestore Timestamp
+  }),
+  description: z.string().max(1000).optional(), // Optional reason
+}
+```
+
+### `updateResourceBlockingEventSchema`
+
+Validates input for updating a blocking event. All fields except IDs are optional.
+
+```typescript
+{
+  clinicBranchId: z.string().min(1),
+  resourceId: z.string().min(1),
+  resourceInstanceId: z.string().min(1),
+  eventId: z.string().min(1),
+  eventName: z.string().min(1).max(200).optional(),
+  eventTime: z.object({ start: z.any(), end: z.any() }).optional(),
+  description: z.string().max(1000).optional(),
+}
+```
+
+## Export
+
+All schemas are exported via `index.ts`.

package/src/validations/index.ts

@@ -15,6 +15,7 @@ export * from "./patient/token.schema";
 export * from "./practitioner.schema";
 export * from "./procedure.schema";
 export * from "./profile-info.schema";
+export * from "./resource.schema";
 export * from "./reviews.schema";
 export * from "./schemas";
 export * from "./shared.schema";

package/src/validations/procedure.schema.ts

@@ -4,11 +4,21 @@ import {
   Currency,
   PricingMeasure,
 } from "../backoffice/types/static/pricing.types";
+import { ResourceCategory } from "../types/resource";
 import { clinicInfoSchema, doctorInfoSchema } from "./shared.schema";
 import { procedureReviewInfoSchema } from "./reviews.schema";
 import { mediaResourceSchema } from "./media.schema";
 import { procedureProductDataSchema } from "./procedure-product.schema";
 
+/**
+ * Schema for a resource requirement reference on a procedure
+ */
+export const resourceRequirementSchema = z.object({
+  resourceId: z.string().min(1),
+  resourceName: z.string().min(1),
+  resourceCategory: z.nativeEnum(ResourceCategory),
+});
+
 /**
  * Schema for validating stored procedure product data (with full product objects).
  * This is used when validating complete procedure documents from Firestore.
@@ -61,6 +71,7 @@ export const createProcedureSchema = z.object({
   practitionerId: z.string().min(1),
   clinicBranchId: z.string().min(1),
   photos: z.array(mediaResourceSchema).optional(),
+  resourceRequirements: z.array(resourceRequirementSchema).optional(),
 });
 
 /**
@@ -83,6 +94,7 @@ export const updateProcedureSchema = z.object({
   productId: z.string().optional(),
   clinicBranchId: z.string().optional(),
   photos: z.array(mediaResourceSchema).optional(),
+  resourceRequirements: z.array(resourceRequirementSchema).optional(),
 });
 
 /**

package/src/validations/resource.schema.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { ResourceCategory, ResourceStatus } from "../types/resource";
+
+/**
+ * Schema for creating a new resource
+ */
+export const createResourceSchema = z.object({
+  clinicBranchId: z.string().min(1),
+  name: z.string().min(1).max(200),
+  category: z.nativeEnum(ResourceCategory),
+  description: z.string().max(1000).optional(),
+  quantity: z.number().int().min(1).max(100),
+});
+
+/**
+ * Schema for updating an existing resource
+ */
+export const updateResourceSchema = z.object({
+  name: z.string().min(1).max(200).optional(),
+  category: z.nativeEnum(ResourceCategory).optional(),
+  description: z.string().max(1000).optional(),
+  quantity: z.number().int().min(1).max(100).optional(),
+  status: z.nativeEnum(ResourceStatus).optional(),
+});
+
+/**
+ * Schema for creating a blocking event on a resource instance
+ */
+export const createResourceBlockingEventSchema = z.object({
+  clinicBranchId: z.string().min(1),
+  resourceId: z.string().min(1),
+  resourceInstanceId: z.string().min(1),
+  eventName: z.string().min(1).max(200),
+  eventTime: z.object({
+    start: z.any(),
+    end: z.any(),
+  }),
+  description: z.string().max(1000).optional(),
+});
+
+/**
+ * Schema for updating a blocking event on a resource instance
+ */
+export const updateResourceBlockingEventSchema = z.object({
+  clinicBranchId: z.string().min(1),
+  resourceId: z.string().min(1),
+  resourceInstanceId: z.string().min(1),
+  eventId: z.string().min(1),
+  eventName: z.string().min(1).max(200).optional(),
+  eventTime: z
+    .object({
+      start: z.any(),
+      end: z.any(),
+    })
+    .optional(),
+  description: z.string().max(1000).optional(),
+});