@valentine-efagene/qshelter-common 2.0.71 → 2.0.72

package/dist/generated/client/models/StepEventAttachment.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/client/models.d.ts

@@ -29,6 +29,7 @@ export type * from './models/PropertyPaymentMethod.js';
 export type * from './models/PropertyPaymentMethodLink.js';
 export type * from './models/PropertyPaymentMethodPhase.js';
 export type * from './models/PaymentMethodPhaseStep.js';
+export type * from './models/StepEventAttachment.js';
 export type * from './models/PaymentMethodPhaseDocument.js';
 export type * from './models/Contract.js';
 export type * from './models/ContractPhase.js';

package/dist/src/events/workflow-event.service.d.ts

@@ -123,10 +123,10 @@ export declare class WorkflowEventService {
             id: string;
             createdAt: Date;
             status: import("./workflow-types").ExecutionStatus;
+            handlerId: string;
             completedAt: Date | null;
             error: string | null;
             eventId: string;
-            handlerId: string;
             attempt: number;
             input: import("@prisma/client/runtime/client").JsonValue | null;
             output: import("@prisma/client/runtime/client").JsonValue | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valentine-efagene/qshelter-common",
-  "version": "2.0.71",
+  "version": "2.0.72",
   "description": "Shared database schemas and utilities for QShelter services",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",

package/prisma/schema.prisma

@@ -84,6 +84,15 @@ enum StepStatus {
   AWAITING_REVIEW // Submitted, waiting for admin/system review
 }
 
+/// When a step event attachment should trigger
+enum StepTrigger {
+  ON_COMPLETE // When step is approved/completed
+  ON_REJECT // When step is rejected
+  ON_SUBMIT // When step is submitted for review
+  ON_RESUBMIT // When step is resubmitted after rejection
+  ON_START // When step transitions to IN_PROGRESS
+}
+
 enum InstallmentStatus {
   PENDING
   PAID
@@ -947,10 +956,42 @@ model PaymentMethodPhaseStep {
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
+  // Event attachments - handlers that fire on step transitions
+  eventAttachments StepEventAttachment[]
+
   @@index([phaseId])
   @@map("payment_method_phase_steps")
 }
 
+/// Step Event Attachment - Links event handlers to step template triggers
+/// When a step transitions (complete, reject, etc.), attached handlers fire
+model StepEventAttachment {
+  id     String @id @default(cuid())
+  stepId String
+  step   PaymentMethodPhaseStep @relation(fields: [stepId], references: [id], onDelete: Cascade)
+
+  /// When this handler should fire
+  trigger StepTrigger
+
+  /// The event handler to execute
+  handlerId String
+  handler   EventHandler @relation(fields: [handlerId], references: [id], onDelete: Cascade)
+
+  /// Order of execution (lower = first)
+  priority Int @default(100)
+
+  /// Whether this attachment is active
+  enabled Boolean @default(true)
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@unique([stepId, handlerId, trigger])
+  @@index([stepId])
+  @@index([handlerId])
+  @@map("step_event_attachments")
+}
+
 // Required document within a DOCUMENTATION phase
 model PaymentMethodPhaseDocument {
   id      String                     @id @default(cuid())
@@ -1789,6 +1830,9 @@ model EventHandler {
   /// Handler execution logs
   executions EventHandlerExecution[]
 
+  /// Step attachments - steps that have attached this handler
+  stepAttachments StepEventAttachment[]
+
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt