@valentine-efagene/qshelter-common 2.0.144 → 2.0.146

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

@@ -25,7 +25,6 @@ export * from './DomainEvent';
 export * from './EmailPreference';
 export * from './EventChannel';
 export * from './EventHandler';
-export * from './EventHandlerExecution';
 export * from './EventType';
 export * from './OAuthState';
 export * from './OfferLetter';
@@ -64,8 +63,6 @@ export * from './RolePermission';
 export * from './ScheduledJob';
 export * from './Settings';
 export * from './Social';
-export * from './StateTransitionDefinition';
-export * from './StateTransitionLog';
 export * from './StepEventAttachment';
 export * from './Tenant';
 export * from './TenantMembership';
@@ -75,4 +72,3 @@ export * from './UserRole';
 export * from './UserSuspension';
 export * from './Wallet';
 export * from './WorkflowBlocker';
-export * from './WorkflowEvent';

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

@@ -25,7 +25,6 @@ export * from './DomainEvent';
 export * from './EmailPreference';
 export * from './EventChannel';
 export * from './EventHandler';
-export * from './EventHandlerExecution';
 export * from './EventType';
 export * from './OAuthState';
 export * from './OfferLetter';
@@ -64,8 +63,6 @@ export * from './RolePermission';
 export * from './ScheduledJob';
 export * from './Settings';
 export * from './Social';
-export * from './StateTransitionDefinition';
-export * from './StateTransitionLog';
 export * from './StepEventAttachment';
 export * from './Tenant';
 export * from './TenantMembership';
@@ -75,4 +72,3 @@ export * from './UserRole';
 export * from './UserSuspension';
 export * from './Wallet';
 export * from './WorkflowBlocker';
-export * from './WorkflowEvent';

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

@@ -66,14 +66,10 @@ export type * from './models/DocumentRequirementRule.js';
 export type * from './models/EventChannel.js';
 export type * from './models/EventType.js';
 export type * from './models/EventHandler.js';
-export type * from './models/WorkflowEvent.js';
-export type * from './models/EventHandlerExecution.js';
 export type * from './models/DomainEvent.js';
 export type * from './models/PropertyTransferRequest.js';
 export type * from './models/ApprovalRequest.js';
 export type * from './models/WorkflowBlocker.js';
-export type * from './models/StateTransitionDefinition.js';
-export type * from './models/StateTransitionLog.js';
 export type * from './models/ScheduledJob.js';
 export type * from './models/DocumentExpiryWarning.js';
 export type * from './commonInputTypes.js';

package/dist/src/prisma/tenant.js

@@ -38,8 +38,6 @@ const OPTIONAL_TENANT_MODELS = [
     "role",
     // Permission can be global template or tenant-specific
     "permission",
-    // StateTransitionDefinition can be global template or tenant-specific
-    "stateTransitionDefinition",
     // ScheduledJob can be system-wide or tenant-specific
     "scheduledJob",
 ];

package/package.json

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

package/prisma/schema.prisma

@@ -367,6 +367,7 @@ enum ApplicationEventType {
   APPLICATION_TRANSFERRED
   UNDERWRITING_COMPLETED
   OFFER_LETTER_GENERATED
+  HANDLER_EXECUTED // Event handler was executed
 }
 
 enum ApplicationEventGroup {
@@ -375,6 +376,7 @@ enum ApplicationEventGroup {
   DOCUMENT
   NOTIFICATION
   WORKFLOW
+  AUTOMATION // Automated handler executions
 }
 
 enum EventActorType {
@@ -410,33 +412,6 @@ enum EventHandlerType {
   LOCK_UNIT // Lock the property unit for the applicant, supersede competing applications
 }
 
-/// Actor Type - Who triggered an event
-enum ActorType {
-  USER
-  API_KEY
-  SYSTEM
-  WEBHOOK
-}
-
-/// Workflow Event Status
-enum WorkflowEventStatus {
-  PENDING
-  PROCESSING
-  COMPLETED
-  FAILED
-  SKIPPED
-}
-
-/// Handler Execution Status
-enum ExecutionStatus {
-  PENDING
-  RUNNING
-  COMPLETED
-  FAILED
-  RETRYING
-  SKIPPED
-}
-
 /// Permission effect (Allow/Deny)
 enum PermissionEffect {
   ALLOW
@@ -848,10 +823,9 @@ model Tenant {
   apiKeys ApiKey[]
 
   // Event-driven workflow
-  eventChannels  EventChannel[]
-  eventTypes     EventType[]
-  eventHandlers  EventHandler[]
-  workflowEvents WorkflowEvent[]
+  eventChannels EventChannel[]
+  eventTypes    EventType[]
+  eventHandlers EventHandler[]
 
   // Property transfer requests
   propertyTransferRequests PropertyTransferRequest[]
@@ -886,7 +860,6 @@ model Tenant {
   propertyVariantMedia        PropertyVariantMedia[]
   propertyUnits               PropertyUnit[]
   propertyAmenities           PropertyAmenity[]
-  eventHandlerExecutions      EventHandlerExecution[]
   amenities                   Amenity[]
   socials                     Social[]
   wallets                     Wallet[]
@@ -907,9 +880,6 @@ model Tenant {
   // Application organization assignments
   applicationOrganizations ApplicationOrganization[]
 
-  // State machine audit
-  stateTransitionLogs StateTransitionLog[]
-
   @@index([subdomain])
   @@map("tenants")
 }
@@ -2143,16 +2113,16 @@ model ApplicationOrganization {
   isPrimary Boolean @default(false)
 
   // Organization-specific terms (e.g., bank's offered interest rate)
-  offeredTerms     Json? // { interestRate, termMonths, conditions, etc. }
-  termsOfferedAt   DateTime?
-  termsAcceptedAt  DateTime?
-  termsDeclinedAt  DateTime?
-  declineReason    String?   @db.Text
+  offeredTerms    Json? // { interestRate, termMonths, conditions, etc. }
+  termsOfferedAt  DateTime?
+  termsAcceptedAt DateTime?
+  termsDeclinedAt DateTime?
+  declineReason   String?   @db.Text
 
   // Tracking
-  activatedAt  DateTime?
-  completedAt  DateTime?
-  withdrawnAt  DateTime?
+  activatedAt DateTime?
+  completedAt DateTime?
+  withdrawnAt DateTime?
 
   // =========================================================================
   // SLA TRACKING - Monitor bank responsiveness
@@ -2160,19 +2130,19 @@ model ApplicationOrganization {
   // When documentation is complete, clock starts for bank to respond.
   // If they're slow, admin can reassign to another bank.
   // =========================================================================
-  slaHours           Int?      // Expected response time (e.g., 48 hours)
-  slaStartedAt       DateTime? // When clock started (e.g., when docs were complete)
-  slaBreachedAt      DateTime? // When SLA was breached (set by cron job)
-  slaBreachNotified  Boolean   @default(false) // Was admin notified of breach?
-  
+  slaHours          Int? // Expected response time (e.g., 48 hours)
+  slaStartedAt      DateTime? // When clock started (e.g., when docs were complete)
+  slaBreachedAt     DateTime? // When SLA was breached (set by cron job)
+  slaBreachNotified Boolean   @default(false) // Was admin notified of breach?
+
   // Reminder tracking
   reminderCount      Int       @default(0)
   lastReminderSentAt DateTime?
   nextReminderAt     DateTime?
-  
+
   // Escalation
   escalatedAt       DateTime?
-  escalatedToUserId String?   // Admin handling the escalation
+  escalatedToUserId String? // Admin handling the escalation
   escalationNotes   String?   @db.Text
 
   createdAt DateTime @default(now())
@@ -2690,7 +2660,7 @@ model ApplicationDocument {
   // =========================================================================
   // expectedUploader is set from DocumentDefinition.uploadedBy at phase creation
   // Allows validation that correct party is uploading (e.g., developer uploads sales offer)
-  expectedUploader UploadedBy? // CUSTOMER, LENDER, DEVELOPER, LEGAL, PLATFORM, etc.
+  expectedUploader       UploadedBy? // CUSTOMER, LENDER, DEVELOPER, LEGAL, PLATFORM, etc.
   // If expectedUploader is LENDER/DEVELOPER, track which org should upload
   expectedOrganizationId String?
 
@@ -2700,13 +2670,13 @@ model ApplicationDocument {
   // Documents like bank statements have a shelf life. If application takes too long,
   // documents may need to be re-uploaded.
   // =========================================================================
-  documentDate     DateTime? // When the document was issued/created (e.g., bank statement date)
-  expiresAt        DateTime? // When this document expires (computed from documentDate + expiryDays)
-  expiryDays       Int? // Number of days this document type is valid (copied from DocumentDefinition)
-  isExpired        Boolean   @default(false) // Denormalized flag, updated by cron job
-  expiredAt        DateTime? // When the document was marked expired
-  expiryWarningAt  DateTime? // When expiry warning was sent
-  revalidatedAt    DateTime? // If document was re-uploaded after expiry
+  documentDate    DateTime? // When the document was issued/created (e.g., bank statement date)
+  expiresAt       DateTime? // When this document expires (computed from documentDate + expiryDays)
+  expiryDays      Int? // Number of days this document type is valid (copied from DocumentDefinition)
+  isExpired       Boolean   @default(false) // Denormalized flag, updated by cron job
+  expiredAt       DateTime? // When the document was marked expired
+  expiryWarningAt DateTime? // When expiry warning was sent
+  revalidatedAt   DateTime? // If document was re-uploaded after expiry
 
   status DocumentStatus @default(PENDING)
 
@@ -3265,9 +3235,6 @@ model EventType {
   /// Handlers subscribed to this event type
   handlers EventHandler[]
 
-  /// Actual event instances of this type
-  events WorkflowEvent[]
-
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
@@ -3318,9 +3285,6 @@ model EventHandler {
   /// e.g., "$.payload.status == 'approved'"
   filterCondition String? @db.Text
 
-  /// Handler execution logs
-  executions EventHandlerExecution[]
-
   /// Step attachments - steps that have attached this handler
   stepAttachments StepEventAttachment[]
 
@@ -3336,100 +3300,6 @@ model EventHandler {
   @@map("event_handlers")
 }
 
-/// Workflow Event - An actual event instance that occurred
-/// This is the audit log of all events in the system
-model WorkflowEvent {
-  id       String @id @default(cuid())
-  tenantId String
-  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
-
-  /// The type of this event
-  eventTypeId String
-  eventType   EventType @relation(fields: [eventTypeId], references: [id], onDelete: Cascade)
-
-  /// The event payload (actual data)
-  payload Json
-
-  /// Optional correlation ID to link related events
-  correlationId String?
-
-  /// Optional causation ID (which event caused this one)
-  causationId String?
-
-  /// Source of the event (service name, user action, etc.)
-  source String
-
-  /// Actor who triggered the event (user ID, API key ID, "system")
-  actorId   String?
-  actorType ActorType @default(SYSTEM)
-
-  /// Event status
-  status WorkflowEventStatus @default(PENDING)
-
-  /// Error message if processing failed
-  error String? @db.Text
-
-  /// When the event was processed
-  processedAt DateTime?
-
-  /// Handler executions for this event
-  executions EventHandlerExecution[]
-
-  createdAt DateTime @default(now())
-
-  @@index([tenantId])
-  @@index([eventTypeId])
-  @@index([correlationId])
-  @@index([causationId])
-  @@index([status])
-  @@index([createdAt])
-  @@map("workflow_events")
-}
-
-/// Event Handler Execution - Log of a handler processing an event
-model EventHandlerExecution {
-  id       String @id @default(cuid())
-  tenantId String
-  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
-
-  /// The event being processed
-  eventId String
-  event   WorkflowEvent @relation(fields: [eventId], references: [id], onDelete: Cascade)
-
-  /// The handler that processed this event
-  handlerId String
-  handler   EventHandler @relation(fields: [handlerId], references: [id], onDelete: Cascade)
-
-  /// Execution status
-  status ExecutionStatus @default(PENDING)
-
-  /// Attempt number (1 for first try, increments on retry)
-  attempt Int @default(1)
-
-  /// Input to the handler (may be transformed payload)
-  input Json?
-
-  /// Output from the handler
-  output Json?
-
-  /// Error details if failed
-  error     String? @db.Text
-  errorCode String?
-
-  /// Timing
-  startedAt   DateTime?
-  completedAt DateTime?
-  durationMs  Int?
-
-  createdAt DateTime @default(now())
-
-  @@index([tenantId])
-  @@index([eventId])
-  @@index([handlerId])
-  @@index([status])
-  @@map("event_handler_executions")
-}
-
 // =============================================================================
 // EVENT OUTBOX - For guaranteed event delivery to SQS queues
 // =============================================================================
@@ -3737,96 +3607,6 @@ model WorkflowBlocker {
   @@map("workflow_blockers")
 }
 
-// =============================================================================
-// STATE MACHINE DEFINITION - Explicit state transitions
-// =============================================================================
-// Defines valid state transitions for applications and phases.
-// This makes the state machine configurable and auditable, rather than
-// being hard-coded in service logic.
-// =============================================================================
-
-/// Entity type that has state machine behavior
-enum StateMachineEntity {
-  APPLICATION
-  APPLICATION_PHASE
-  DOCUMENTATION_STAGE
-  DOCUMENT
-}
-
-/// State Machine Transition Definition - Configurable state transitions
-/// Allows admins to customize workflows without code changes
-model StateTransitionDefinition {
-  id       String @id @default(cuid())
-  tenantId String? // NULL = global template, set = tenant-specific override
-
-  // What entity this transition applies to
-  entityType StateMachineEntity
-
-  // The transition
-  fromState String // e.g., "DRAFT", "PENDING", "IN_PROGRESS"
-  toState   String // e.g., "ACTIVE", "COMPLETED"
-  trigger   String // e.g., "SUBMIT", "APPROVE", "COMPLETE"
-
-  // Transition constraints
-  isEnabled     Boolean @default(true)
-  requiresRole  String? // Role required to trigger this transition
-  requiresPhase String? // Phase type required (for APPLICATION transitions)
-
-  // Side effects configuration
-  sideEffects Json? // [{ type: "SEND_EMAIL", config: {...} }, { type: "LOCK_UNIT" }]
-
-  // Audit
-  description String?  @db.Text
-  createdAt   DateTime @default(now())
-  updatedAt   DateTime @updatedAt
-
-  @@unique([tenantId, entityType, fromState, trigger])
-  @@index([entityType])
-  @@index([fromState])
-  @@index([trigger])
-  @@map("state_transition_definitions")
-}
-
-/// State Transition Log - Audit trail for all state changes
-/// Records every state transition for compliance and debugging
-model StateTransitionLog {
-  id       String @id @default(cuid())
-  tenantId String
-  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
-
-  // What entity changed state
-  entityType StateMachineEntity
-  entityId   String // Application ID, Phase ID, Document ID, etc.
-
-  // The transition that occurred
-  fromState String
-  toState   String
-  trigger   String
-
-  // Who triggered the transition
-  actorId   String?
-  actorType EventActorType?
-
-  // Context at time of transition
-  contextSnapshot Json? // Relevant data at time of transition (phase data, payment amounts, etc.)
-
-  // Timing
-  occurredAt DateTime @default(now())
-  durationMs Int? // How long the entity was in fromState
-
-  // Validation
-  wasValid     Boolean @default(true) // Was this a valid transition per state machine?
-  errorMessage String? @db.Text // If invalid, why?
-
-  @@index([tenantId])
-  @@index([entityType, entityId])
-  @@index([entityType, fromState])
-  @@index([entityType, toState])
-  @@index([occurredAt])
-  @@index([actorId])
-  @@map("state_transition_logs")
-}
-
 // =============================================================================
 // DOCUMENT EXPIRY JOB - Scheduled job tracking for document expiration checks
 // =============================================================================
@@ -3857,7 +3637,7 @@ enum ScheduledJobType {
 
 /// Scheduled Job - Tracks execution of background jobs
 model ScheduledJob {
-  id       String @id @default(cuid())
+  id       String  @id @default(cuid())
   tenantId String? // NULL = system-wide job, set = tenant-specific
 
   jobType ScheduledJobType
@@ -3902,8 +3682,8 @@ model DocumentExpiryWarning {
   documentId String
 
   // Warning details
-  expiresAt  DateTime // When document will expire
-  daysUntil  Int // Days until expiry at time of warning
+  expiresAt   DateTime // When document will expire
+  daysUntil   Int // Days until expiry at time of warning
   warningSent DateTime @default(now())
 
   // Customer notification tracking