@lssm/example.workflow-system 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/approval/approval.handler.js

@@ -1 +1,71 @@
-import{mockDataStore as e}from"../shared/mock-data.js";import{handleTransitionWorkflow as t}from"../instance/instance.handler.js";async function n(t,n,r){let i=new Date;for(let r=0;r<n.approverRoles.length;r++){let a=n.approverRoles[r],o=`approval_${Date.now()}_${r}`,s={id:o,workflowInstanceId:t.id,stepExecutionId:`exec_${t.id}_${n.id}`,approverId:`user_${a}`,approverRole:a,title:`Approval required for ${n.name}`,description:n.description,status:`PENDING`,contextSnapshot:t.contextData,sequenceOrder:r,createdAt:i,updatedAt:i};e.approvals.set(o,s)}}async function r(n,r){let i=e.approvals.get(n.requestId);if(!i)throw Error(`Approval request ${n.requestId} not found`);if(i.approverId!==r.userId&&!r.userRoles.includes(i.approverRole??``))throw Error(`User is not authorized to make this decision`);let a=new Date;return i.decision=n.decision,i.decisionComment=n.comment,i.decidedAt=a,i.updatedAt=a,n.decision===`APPROVE`?(i.status=`APPROVED`,await t({instanceId:i.workflowInstanceId,action:`approve`,data:n.data,comment:n.comment},r)):n.decision===`REJECT`&&(i.status=`REJECTED`,await t({instanceId:i.workflowInstanceId,action:`reject`,data:n.data,comment:n.comment},r)),i}async function i(t,n){let r=Array.from(e.approvals.values()).filter(e=>e.approverId===n.userId||n.userRoles.includes(e.approverRole??``)),i=r.filter(e=>e.status===`PENDING`).length;t.status&&(r=r.filter(e=>e.status===t.status));let a=r.length,o=t.offset??0,s=t.limit??20;return r=r.sort((e,t)=>t.createdAt.getTime()-e.createdAt.getTime()).slice(o,o+s),{requests:r,total:a,pendingCount:i}}export{n as createApprovalRequests,i as handleListMyApprovals,r as handleSubmitDecision};
+import { mockDataStore } from "../shared/mock-data.js";
+import { handleTransitionWorkflow } from "../instance/instance.handler.js";
+
+//#region src/approval/approval.handler.ts
+async function createApprovalRequests(instance, step, _context) {
+	const now = /* @__PURE__ */ new Date();
+	for (let i = 0; i < step.approverRoles.length; i++) {
+		const role = step.approverRoles[i];
+		const id = `approval_${Date.now()}_${i}`;
+		const request = {
+			id,
+			workflowInstanceId: instance.id,
+			stepExecutionId: `exec_${instance.id}_${step.id}`,
+			approverId: `user_${role}`,
+			approverRole: role,
+			title: `Approval required for ${step.name}`,
+			description: step.description,
+			status: "PENDING",
+			contextSnapshot: instance.contextData,
+			sequenceOrder: i,
+			createdAt: now,
+			updatedAt: now
+		};
+		mockDataStore.approvals.set(id, request);
+	}
+}
+async function handleSubmitDecision(input, context) {
+	const request = mockDataStore.approvals.get(input.requestId);
+	if (!request) throw new Error(`Approval request ${input.requestId} not found`);
+	if (request.approverId !== context.userId && !context.userRoles.includes(request.approverRole ?? "")) throw new Error("User is not authorized to make this decision");
+	const now = /* @__PURE__ */ new Date();
+	request.decision = input.decision;
+	request.decisionComment = input.comment;
+	request.decidedAt = now;
+	request.updatedAt = now;
+	if (input.decision === "APPROVE") {
+		request.status = "APPROVED";
+		await handleTransitionWorkflow({
+			instanceId: request.workflowInstanceId,
+			action: "approve",
+			data: input.data,
+			comment: input.comment
+		}, context);
+	} else if (input.decision === "REJECT") {
+		request.status = "REJECTED";
+		await handleTransitionWorkflow({
+			instanceId: request.workflowInstanceId,
+			action: "reject",
+			data: input.data,
+			comment: input.comment
+		}, context);
+	}
+	return request;
+}
+async function handleListMyApprovals(input, context) {
+	let requests = Array.from(mockDataStore.approvals.values()).filter((r) => r.approverId === context.userId || context.userRoles.includes(r.approverRole ?? ""));
+	const pendingCount = requests.filter((r) => r.status === "PENDING").length;
+	if (input.status) requests = requests.filter((r) => r.status === input.status);
+	const total = requests.length;
+	const offset = input.offset ?? 0;
+	const limit = input.limit ?? 20;
+	requests = requests.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime()).slice(offset, offset + limit);
+	return {
+		requests,
+		total,
+		pendingCount
+	};
+}
+
+//#endregion
+export { createApprovalRequests, handleListMyApprovals, handleSubmitDecision };

package/dist/approval/approval.schema.d.ts

@@ -1,97 +1,97 @@
-import * as _lssm_lib_schema161 from "@lssm/lib.schema";
+import * as _lssm_lib_schema260 from "@lssm/lib.schema";
 
 //#region src/approval/approval.schema.d.ts
 /**
  * An approval request.
  */
-declare const ApprovalRequestModel: _lssm_lib_schema161.SchemaModel<{
+declare const ApprovalRequestModel: _lssm_lib_schema260.SchemaModel<{
   id: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: false;
   };
   workflowInstanceId: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: false;
   };
   stepExecutionId: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: false;
   };
   approverId: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: false;
   };
   approverRole: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: true;
   };
   title: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: false;
   };
   description: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: true;
   };
   status: {
-    type: _lssm_lib_schema161.EnumType<[string, string, string, string, string, string, string]>;
+    type: _lssm_lib_schema260.EnumType<[string, string, string, string, string, string, string]>;
     isOptional: false;
   };
   decision: {
-    type: _lssm_lib_schema161.EnumType<[string, string, string, string, string]>;
+    type: _lssm_lib_schema260.EnumType<[string, string, string, string, string]>;
     isOptional: true;
   };
   decisionComment: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: true;
   };
   decidedAt: {
-    type: _lssm_lib_schema161.FieldType<Date, string>;
+    type: _lssm_lib_schema260.FieldType<Date, string>;
     isOptional: true;
   };
   dueAt: {
-    type: _lssm_lib_schema161.FieldType<Date, string>;
+    type: _lssm_lib_schema260.FieldType<Date, string>;
     isOptional: true;
   };
   contextSnapshot: {
-    type: _lssm_lib_schema161.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema260.FieldType<unknown, unknown>;
     isOptional: true;
   };
   sequenceOrder: {
-    type: _lssm_lib_schema161.FieldType<number, number>;
+    type: _lssm_lib_schema260.FieldType<number, number>;
     isOptional: false;
   };
   createdAt: {
-    type: _lssm_lib_schema161.FieldType<Date, string>;
+    type: _lssm_lib_schema260.FieldType<Date, string>;
     isOptional: false;
   };
 }>;
 /**
  * A comment on an approval.
  */
-declare const ApprovalCommentModel: _lssm_lib_schema161.SchemaModel<{
+declare const ApprovalCommentModel: _lssm_lib_schema260.SchemaModel<{
   id: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: false;
   };
   approvalRequestId: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: false;
   };
   authorId: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: false;
   };
   content: {
-    type: _lssm_lib_schema161.FieldType<string, string>;
+    type: _lssm_lib_schema260.FieldType<string, string>;
     isOptional: false;
   };
   isInternal: {
-    type: _lssm_lib_schema161.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema260.FieldType<boolean, boolean>;
     isOptional: false;
   };
   createdAt: {
-    type: _lssm_lib_schema161.FieldType<Date, string>;
+    type: _lssm_lib_schema260.FieldType<Date, string>;
     isOptional: false;
   };
 }>;

package/dist/approval/approval.schema.js

@@ -1 +1,111 @@
-import{l as e}from"../libs/schema/dist/ScalarTypeEnum.js";import{n as t}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";import{ApprovalDecisionEnum as n,ApprovalStatusEnum as r}from"./approval.enum.js";const i=t({name:`ApprovalRequestModel`,description:`An approval request`,fields:{id:{type:e.String_unsecure(),isOptional:!1},workflowInstanceId:{type:e.String_unsecure(),isOptional:!1},stepExecutionId:{type:e.String_unsecure(),isOptional:!1},approverId:{type:e.String_unsecure(),isOptional:!1},approverRole:{type:e.String_unsecure(),isOptional:!0},title:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},status:{type:r,isOptional:!1},decision:{type:n,isOptional:!0},decisionComment:{type:e.String_unsecure(),isOptional:!0},decidedAt:{type:e.DateTime(),isOptional:!0},dueAt:{type:e.DateTime(),isOptional:!0},contextSnapshot:{type:e.JSON(),isOptional:!0},sequenceOrder:{type:e.Int_unsecure(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),a=t({name:`ApprovalCommentModel`,description:`A comment on an approval`,fields:{id:{type:e.String_unsecure(),isOptional:!1},approvalRequestId:{type:e.String_unsecure(),isOptional:!1},authorId:{type:e.String_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},isInternal:{type:e.Boolean(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}});export{a as ApprovalCommentModel,i as ApprovalRequestModel};
+import { ScalarTypeEnum } from "../libs/schema/dist/ScalarTypeEnum.js";
+import { defineSchemaModel } from "../libs/schema/dist/SchemaModel.js";
+import "../libs/schema/dist/index.js";
+import { ApprovalDecisionEnum, ApprovalStatusEnum } from "./approval.enum.js";
+
+//#region src/approval/approval.schema.ts
+/**
+* An approval request.
+*/
+const ApprovalRequestModel = defineSchemaModel({
+	name: "ApprovalRequestModel",
+	description: "An approval request",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		workflowInstanceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		stepExecutionId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		approverId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		approverRole: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		title: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		status: {
+			type: ApprovalStatusEnum,
+			isOptional: false
+		},
+		decision: {
+			type: ApprovalDecisionEnum,
+			isOptional: true
+		},
+		decisionComment: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		decidedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		dueAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		contextSnapshot: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		sequenceOrder: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* A comment on an approval.
+*/
+const ApprovalCommentModel = defineSchemaModel({
+	name: "ApprovalCommentModel",
+	description: "A comment on an approval",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		approvalRequestId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		authorId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		content: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		isInternal: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+
+//#endregion
+export { ApprovalCommentModel, ApprovalRequestModel };

package/dist/approval/index.js

@@ -1 +1,6 @@
-import{ApprovalDecisionEnum as e,ApprovalStatusEnum as t}from"./approval.enum.js";import{ApprovalCommentModel as n,ApprovalRequestModel as r}from"./approval.schema.js";import{AddApprovalCommentContract as i,DelegateApprovalContract as a,GetApprovalContract as o,ListMyApprovalsContract as s,SubmitDecisionContract as c}from"./approval.contracts.js";import{ApprovalDecidedEvent as l,ApprovalDelegatedEvent as u,ApprovalEscalatedEvent as d,ApprovalRequestedEvent as f}from"./approval.event.js";export{i as AddApprovalCommentContract,n as ApprovalCommentModel,l as ApprovalDecidedEvent,e as ApprovalDecisionEnum,u as ApprovalDelegatedEvent,d as ApprovalEscalatedEvent,r as ApprovalRequestModel,f as ApprovalRequestedEvent,t as ApprovalStatusEnum,a as DelegateApprovalContract,o as GetApprovalContract,s as ListMyApprovalsContract,c as SubmitDecisionContract};
+import { ApprovalDecisionEnum, ApprovalStatusEnum } from "./approval.enum.js";
+import { ApprovalCommentModel, ApprovalRequestModel } from "./approval.schema.js";
+import { AddApprovalCommentContract, DelegateApprovalContract, GetApprovalContract, ListMyApprovalsContract, SubmitDecisionContract } from "./approval.contracts.js";
+import { ApprovalDecidedEvent, ApprovalDelegatedEvent, ApprovalEscalatedEvent, ApprovalRequestedEvent } from "./approval.event.js";
+
+export { AddApprovalCommentContract, ApprovalCommentModel, ApprovalDecidedEvent, ApprovalDecisionEnum, ApprovalDelegatedEvent, ApprovalEscalatedEvent, ApprovalRequestModel, ApprovalRequestedEvent, ApprovalStatusEnum, DelegateApprovalContract, GetApprovalContract, ListMyApprovalsContract, SubmitDecisionContract };

package/dist/docs/index.js

@@ -1 +1 @@
-import"./workflow-system.docblock.js";
+import "./workflow-system.docblock.js";

package/dist/docs/workflow-system.docblock.js

@@ -1,4 +1,22 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{id:`docs.examples.workflow-system`,title:`Workflow / Approval System`,summary:`Reference app showing state-machine driven approvals with RBAC, audit trail, notifications, and jobs.`,kind:`reference`,visibility:`public`,route:`/docs/examples/workflow-system`,tags:[`workflow`,`approval`,`state-machine`,`rbac`],body:`## Entities
+import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
+
+//#region src/docs/workflow-system.docblock.ts
+registerDocBlocks([
+	{
+		id: "docs.examples.workflow-system",
+		title: "Workflow / Approval System",
+		summary: "Reference app showing state-machine driven approvals with RBAC, audit trail, notifications, and jobs.",
+		kind: "reference",
+		visibility: "public",
+		route: "/docs/examples/workflow-system",
+		tags: [
+			"workflow",
+			"approval",
+			"state-machine",
+			"rbac"
+		],
+		body: `## Entities
 
 - WorkflowDefinition, WorkflowStep, WorkflowInstance, Approval.
 - State machine expressed in \`src/state-machine\` with allowed transitions and role gates.
@@ -22,7 +40,17 @@ import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 
 - Keep transitions declarative to enable safe regeneration; role guards live in spec.
 - Use Notification Center for approval requests and outcomes; attach files via Files module if needed.
-`},{id:`docs.examples.workflow-system.goal`,title:`Workflow System — Goal`,summary:`Why the workflow/approval template exists and outcomes it targets.`,kind:`goal`,visibility:`public`,route:`/docs/examples/workflow-system/goal`,tags:[`workflow`,`goal`],body:`## Why it matters
+`
+	},
+	{
+		id: "docs.examples.workflow-system.goal",
+		title: "Workflow System — Goal",
+		summary: "Why the workflow/approval template exists and outcomes it targets.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/examples/workflow-system/goal",
+		tags: ["workflow", "goal"],
+		body: `## Why it matters
 - Provides a regenerable, role-gated approval engine using declarative state machines.
 - Keeps workflow rules consistent across UI/API/events with auditability.
 
@@ -32,7 +60,17 @@ import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 
 ## Success criteria
 - State changes are declarative and regenerate cleanly.
-- Every transition emits auditable events and respects RBAC guards.`},{id:`docs.examples.workflow-system.usage`,title:`Workflow System — Usage`,summary:`How to configure workflows, transitions, and regenerate safely.`,kind:`usage`,visibility:`public`,route:`/docs/examples/workflow-system/usage`,tags:[`workflow`,`usage`],body:`## Setup
+- Every transition emits auditable events and respects RBAC guards.`
+	},
+	{
+		id: "docs.examples.workflow-system.usage",
+		title: "Workflow System — Usage",
+		summary: "How to configure workflows, transitions, and regenerate safely.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/examples/workflow-system/usage",
+		tags: ["workflow", "usage"],
+		body: `## Setup
 1) Define WorkflowDefinition steps and allowed transitions with role gates in spec.
 2) Seed sample workflows/instances (if provided) or create via UI; enable reminders via Jobs.
 
@@ -44,7 +82,21 @@ import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 ## Guardrails
 - Emit events for every transition; log to Audit Trail.
 - Use Notifications for approvals/rejections; schedule reminders for pending steps.
-- Keep transitions declarative; avoid imperative branching in handlers.`},{id:`docs.examples.workflow-system.constraints`,title:`Workflow System — Constraints & Safety`,summary:`Internal guardrails for state machines, RBAC, and regeneration semantics.`,kind:`reference`,visibility:`internal`,route:`/docs/examples/workflow-system/constraints`,tags:[`workflow`,`constraints`,`internal`],body:`## Constraints
+- Keep transitions declarative; avoid imperative branching in handlers.`
+	},
+	{
+		id: "docs.examples.workflow-system.constraints",
+		title: "Workflow System — Constraints & Safety",
+		summary: "Internal guardrails for state machines, RBAC, and regeneration semantics.",
+		kind: "reference",
+		visibility: "internal",
+		route: "/docs/examples/workflow-system/constraints",
+		tags: [
+			"workflow",
+			"constraints",
+			"internal"
+		],
+		body: `## Constraints
 - State machine (steps/transitions) must stay declarative in spec; no hidden code paths.
 - Events to emit: instance.started, step.completed/rejected, instance.finished.
 - Regeneration must not change approval logic without explicit spec diff.
@@ -56,4 +108,8 @@ import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 ## Verification
 - Add fixtures for transition changes and role gates.
 - Validate reminders (Jobs) stay aligned with pending states after regeneration.
-- Use Feature Flags for new transitions/escalation rules; default safe/off.`}]);
+- Use Feature Flags for new transitions/escalation rules; default safe/off.`
+	}
+]);
+
+//#endregion

package/dist/entities/approval.d.ts

@@ -1,57 +1,57 @@
-import * as _lssm_lib_schema1145 from "@lssm/lib.schema";
+import * as _lssm_lib_schema61 from "@lssm/lib.schema";
 
 //#region src/entities/approval.d.ts
 /**
  * Approval status enum.
  */
-declare const ApprovalStatusEnum: _lssm_lib_schema1145.EntityEnumDef;
+declare const ApprovalStatusEnum: _lssm_lib_schema61.EntityEnumDef;
 /**
  * Approval decision enum.
  */
-declare const ApprovalDecisionEnum: _lssm_lib_schema1145.EntityEnumDef;
+declare const ApprovalDecisionEnum: _lssm_lib_schema61.EntityEnumDef;
 /**
  * ApprovalRequest entity - a request for approval from a user.
  *
  * Created when a workflow reaches an APPROVAL step. Multiple requests
  * may be created depending on the approval mode.
  */
-declare const ApprovalRequestEntity: _lssm_lib_schema1145.EntitySpec<{
-  id: _lssm_lib_schema1145.EntityScalarField;
-  workflowInstanceId: _lssm_lib_schema1145.EntityScalarField;
-  stepExecutionId: _lssm_lib_schema1145.EntityScalarField;
-  approverId: _lssm_lib_schema1145.EntityScalarField;
-  approverRole: _lssm_lib_schema1145.EntityScalarField;
-  title: _lssm_lib_schema1145.EntityScalarField;
-  description: _lssm_lib_schema1145.EntityScalarField;
-  status: _lssm_lib_schema1145.EntityEnumField;
-  decision: _lssm_lib_schema1145.EntityEnumField;
-  decisionComment: _lssm_lib_schema1145.EntityScalarField;
-  decidedAt: _lssm_lib_schema1145.EntityScalarField;
-  delegatedTo: _lssm_lib_schema1145.EntityScalarField;
-  delegationReason: _lssm_lib_schema1145.EntityScalarField;
-  escalationLevel: _lssm_lib_schema1145.EntityScalarField;
-  escalatedAt: _lssm_lib_schema1145.EntityScalarField;
-  dueAt: _lssm_lib_schema1145.EntityScalarField;
-  reminderSentAt: _lssm_lib_schema1145.EntityScalarField;
-  contextSnapshot: _lssm_lib_schema1145.EntityScalarField;
-  sequenceOrder: _lssm_lib_schema1145.EntityScalarField;
-  createdAt: _lssm_lib_schema1145.EntityScalarField;
-  updatedAt: _lssm_lib_schema1145.EntityScalarField;
-  workflowInstance: _lssm_lib_schema1145.EntityRelationField;
-  stepExecution: _lssm_lib_schema1145.EntityRelationField;
+declare const ApprovalRequestEntity: _lssm_lib_schema61.EntitySpec<{
+  id: _lssm_lib_schema61.EntityScalarField;
+  workflowInstanceId: _lssm_lib_schema61.EntityScalarField;
+  stepExecutionId: _lssm_lib_schema61.EntityScalarField;
+  approverId: _lssm_lib_schema61.EntityScalarField;
+  approverRole: _lssm_lib_schema61.EntityScalarField;
+  title: _lssm_lib_schema61.EntityScalarField;
+  description: _lssm_lib_schema61.EntityScalarField;
+  status: _lssm_lib_schema61.EntityEnumField;
+  decision: _lssm_lib_schema61.EntityEnumField;
+  decisionComment: _lssm_lib_schema61.EntityScalarField;
+  decidedAt: _lssm_lib_schema61.EntityScalarField;
+  delegatedTo: _lssm_lib_schema61.EntityScalarField;
+  delegationReason: _lssm_lib_schema61.EntityScalarField;
+  escalationLevel: _lssm_lib_schema61.EntityScalarField;
+  escalatedAt: _lssm_lib_schema61.EntityScalarField;
+  dueAt: _lssm_lib_schema61.EntityScalarField;
+  reminderSentAt: _lssm_lib_schema61.EntityScalarField;
+  contextSnapshot: _lssm_lib_schema61.EntityScalarField;
+  sequenceOrder: _lssm_lib_schema61.EntityScalarField;
+  createdAt: _lssm_lib_schema61.EntityScalarField;
+  updatedAt: _lssm_lib_schema61.EntityScalarField;
+  workflowInstance: _lssm_lib_schema61.EntityRelationField;
+  stepExecution: _lssm_lib_schema61.EntityRelationField;
 }>;
 /**
  * ApprovalComment entity - comments on approval requests.
  */
-declare const ApprovalCommentEntity: _lssm_lib_schema1145.EntitySpec<{
-  id: _lssm_lib_schema1145.EntityScalarField;
-  approvalRequestId: _lssm_lib_schema1145.EntityScalarField;
-  authorId: _lssm_lib_schema1145.EntityScalarField;
-  content: _lssm_lib_schema1145.EntityScalarField;
-  isInternal: _lssm_lib_schema1145.EntityScalarField;
-  createdAt: _lssm_lib_schema1145.EntityScalarField;
-  updatedAt: _lssm_lib_schema1145.EntityScalarField;
-  approvalRequest: _lssm_lib_schema1145.EntityRelationField;
+declare const ApprovalCommentEntity: _lssm_lib_schema61.EntitySpec<{
+  id: _lssm_lib_schema61.EntityScalarField;
+  approvalRequestId: _lssm_lib_schema61.EntityScalarField;
+  authorId: _lssm_lib_schema61.EntityScalarField;
+  content: _lssm_lib_schema61.EntityScalarField;
+  isInternal: _lssm_lib_schema61.EntityScalarField;
+  createdAt: _lssm_lib_schema61.EntityScalarField;
+  updatedAt: _lssm_lib_schema61.EntityScalarField;
+  approvalRequest: _lssm_lib_schema61.EntityRelationField;
 }>;
 //#endregion
 export { ApprovalCommentEntity, ApprovalDecisionEnum, ApprovalRequestEntity, ApprovalStatusEnum };

package/dist/entities/approval.js

@@ -1 +1,128 @@
-import{i as e,n as t,r as n,t as r}from"../libs/schema/dist/entity/defineEntity.js";import"../libs/schema/dist/index.js";const i=t({name:`ApprovalStatus`,values:[`PENDING`,`APPROVED`,`REJECTED`,`DELEGATED`,`ESCALATED`,`WITHDRAWN`,`EXPIRED`],schema:`workflow`,description:`Status of an approval request.`}),a=t({name:`ApprovalDecision`,values:[`APPROVE`,`REJECT`,`REQUEST_CHANGES`,`DELEGATE`,`ABSTAIN`],schema:`workflow`,description:`Possible approval decisions.`}),o=r({name:`ApprovalRequest`,description:`A pending approval request for a workflow step.`,schema:`workflow`,map:`approval_request`,fields:{id:n.id({description:`Unique approval request ID`}),workflowInstanceId:n.foreignKey(),stepExecutionId:n.foreignKey(),approverId:n.foreignKey({description:`User requested to approve`}),approverRole:n.string({isOptional:!0,description:`Role of the approver`}),title:n.string({description:`Approval request title`}),description:n.string({isOptional:!0}),status:n.enum(`ApprovalStatus`,{default:`PENDING`}),decision:n.enum(`ApprovalDecision`,{isOptional:!0}),decisionComment:n.string({isOptional:!0,description:`Comment explaining decision`}),decidedAt:n.dateTime({isOptional:!0}),delegatedTo:n.string({isOptional:!0,description:`User delegated to`}),delegationReason:n.string({isOptional:!0}),escalationLevel:n.int({default:0,description:`Current escalation level`}),escalatedAt:n.dateTime({isOptional:!0}),dueAt:n.dateTime({isOptional:!0,description:`When approval is due`}),reminderSentAt:n.dateTime({isOptional:!0}),contextSnapshot:n.json({isOptional:!0,description:`Snapshot of relevant data for review`}),sequenceOrder:n.int({default:0,description:`Order in approval chain`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),workflowInstance:n.belongsTo(`WorkflowInstance`,[`workflowInstanceId`],[`id`],{onDelete:`Cascade`}),stepExecution:n.belongsTo(`StepExecution`,[`stepExecutionId`],[`id`])},indexes:[e.on([`approverId`,`status`]),e.on([`workflowInstanceId`,`status`]),e.on([`stepExecutionId`]),e.on([`status`,`dueAt`]),e.on([`createdAt`])],enums:[i,a]}),s=r({name:`ApprovalComment`,description:`A comment on an approval request.`,schema:`workflow`,map:`approval_comment`,fields:{id:n.id(),approvalRequestId:n.foreignKey(),authorId:n.foreignKey(),content:n.string({description:`Comment text`}),isInternal:n.boolean({default:!1,description:`Internal note vs public comment`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),approvalRequest:n.belongsTo(`ApprovalRequest`,[`approvalRequestId`],[`id`],{onDelete:`Cascade`})},indexes:[e.on([`approvalRequestId`,`createdAt`])]});export{s as ApprovalCommentEntity,a as ApprovalDecisionEnum,o as ApprovalRequestEntity,i as ApprovalStatusEnum};
+import { defineEntity, defineEntityEnum, field, index } from "../libs/schema/dist/entity/defineEntity.js";
+import "../libs/schema/dist/index.js";
+
+//#region src/entities/approval.ts
+/**
+* Approval status enum.
+*/
+const ApprovalStatusEnum = defineEntityEnum({
+	name: "ApprovalStatus",
+	values: [
+		"PENDING",
+		"APPROVED",
+		"REJECTED",
+		"DELEGATED",
+		"ESCALATED",
+		"WITHDRAWN",
+		"EXPIRED"
+	],
+	schema: "workflow",
+	description: "Status of an approval request."
+});
+/**
+* Approval decision enum.
+*/
+const ApprovalDecisionEnum = defineEntityEnum({
+	name: "ApprovalDecision",
+	values: [
+		"APPROVE",
+		"REJECT",
+		"REQUEST_CHANGES",
+		"DELEGATE",
+		"ABSTAIN"
+	],
+	schema: "workflow",
+	description: "Possible approval decisions."
+});
+/**
+* ApprovalRequest entity - a request for approval from a user.
+*
+* Created when a workflow reaches an APPROVAL step. Multiple requests
+* may be created depending on the approval mode.
+*/
+const ApprovalRequestEntity = defineEntity({
+	name: "ApprovalRequest",
+	description: "A pending approval request for a workflow step.",
+	schema: "workflow",
+	map: "approval_request",
+	fields: {
+		id: field.id({ description: "Unique approval request ID" }),
+		workflowInstanceId: field.foreignKey(),
+		stepExecutionId: field.foreignKey(),
+		approverId: field.foreignKey({ description: "User requested to approve" }),
+		approverRole: field.string({
+			isOptional: true,
+			description: "Role of the approver"
+		}),
+		title: field.string({ description: "Approval request title" }),
+		description: field.string({ isOptional: true }),
+		status: field.enum("ApprovalStatus", { default: "PENDING" }),
+		decision: field.enum("ApprovalDecision", { isOptional: true }),
+		decisionComment: field.string({
+			isOptional: true,
+			description: "Comment explaining decision"
+		}),
+		decidedAt: field.dateTime({ isOptional: true }),
+		delegatedTo: field.string({
+			isOptional: true,
+			description: "User delegated to"
+		}),
+		delegationReason: field.string({ isOptional: true }),
+		escalationLevel: field.int({
+			default: 0,
+			description: "Current escalation level"
+		}),
+		escalatedAt: field.dateTime({ isOptional: true }),
+		dueAt: field.dateTime({
+			isOptional: true,
+			description: "When approval is due"
+		}),
+		reminderSentAt: field.dateTime({ isOptional: true }),
+		contextSnapshot: field.json({
+			isOptional: true,
+			description: "Snapshot of relevant data for review"
+		}),
+		sequenceOrder: field.int({
+			default: 0,
+			description: "Order in approval chain"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		workflowInstance: field.belongsTo("WorkflowInstance", ["workflowInstanceId"], ["id"], { onDelete: "Cascade" }),
+		stepExecution: field.belongsTo("StepExecution", ["stepExecutionId"], ["id"])
+	},
+	indexes: [
+		index.on(["approverId", "status"]),
+		index.on(["workflowInstanceId", "status"]),
+		index.on(["stepExecutionId"]),
+		index.on(["status", "dueAt"]),
+		index.on(["createdAt"])
+	],
+	enums: [ApprovalStatusEnum, ApprovalDecisionEnum]
+});
+/**
+* ApprovalComment entity - comments on approval requests.
+*/
+const ApprovalCommentEntity = defineEntity({
+	name: "ApprovalComment",
+	description: "A comment on an approval request.",
+	schema: "workflow",
+	map: "approval_comment",
+	fields: {
+		id: field.id(),
+		approvalRequestId: field.foreignKey(),
+		authorId: field.foreignKey(),
+		content: field.string({ description: "Comment text" }),
+		isInternal: field.boolean({
+			default: false,
+			description: "Internal note vs public comment"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		approvalRequest: field.belongsTo("ApprovalRequest", ["approvalRequestId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [index.on(["approvalRequestId", "createdAt"])]
+});
+
+//#endregion
+export { ApprovalCommentEntity, ApprovalDecisionEnum, ApprovalRequestEntity, ApprovalStatusEnum };