@loop-engine/dsl

1npm install @loop-engine/dsl

1LoopBuilder.create(id: string, domain: string): LoopBuilder

1import { LoopBuilder } from "@loop-engine/dsl"
2 
3const approval = LoopBuilder
4  .create("expense.approval", "finance")
5  .version("1.0.0")
6  .description("Expense approval loop")
7  .state("SUBMITTED")
8  .state("UNDER_REVIEW")
9  .state("APPROVED", { isTerminal: true })
10  .state("REJECTED", { isTerminal: true })
11  .initialState("SUBMITTED")
12  .transition({
13    id: "start_review",
14    from: "SUBMITTED",
15    to: "UNDER_REVIEW",
16    actors: ["automation"]
17  })
18  .transition({
19    id: "approve",
20    from: "UNDER_REVIEW",
21    to: "APPROVED",
22    actors: ["human"],
23    guards: [
24      {
25        id: "approval_obtained" as never,
26        description: "Manager approval required",
27        failureMessage: "Approval missing",
28        severity: "hard",
29        evaluatedBy: "runtime"
30      }
31    ]
32  })
33  .outcome({
34    id: "expense_approved",
35    description: "Expense approved",
36    valueUnit: "expense_approved",
37    measurable: true
38  })
39  .build()

1import { parseLoopYaml } from "@loop-engine/dsl"
2 
3const definition = parseLoopYaml(yamlString)

1id: expense.approval
2version: 1.0.0
3description: Expense approval loop
4domain: finance
5states:
6  - id: SUBMITTED
7  - id: UNDER_REVIEW
8  - id: APPROVED
9    isTerminal: true
10  - id: REJECTED
11    isTerminal: true
12initialState: SUBMITTED
13transitions:
14  - id: start_review
15    from: SUBMITTED
16    to: UNDER_REVIEW
17    allowedActors: [automation]
18  - id: approve
19    from: UNDER_REVIEW
20    to: APPROVED
21    allowedActors: [human]
22    guards:
23      - id: approval_obtained
24        description: Manager approval required
25        failureMessage: Approval missing
26        severity: hard
27        evaluatedBy: runtime
28outcome:
29  id: expense_approved
30  description: Expense approved
31  valueUnit: expense_approved
32  measurable: true

1import {
2  parseLoopJson,
3  parseLoopYaml,
4  serializeLoopJson,
5  serializeLoopYaml,
6  validateLoopDefinition
7} from "@loop-engine/dsl"

1validateLoopDefinition(definition: LoopDefinition): ValidationResult
2 
3interface ValidationResult {
4  valid: boolean
5  errors: ValidationError[]
6}
7 
8interface ValidationError {
9  code: string
10  message: string
11  path?: string
12}

1{
2  valid: false,
3  errors: [
4    {
5      code: "INVALID_INITIAL_STATE",
6      message: 'initialState "DRAFT" does not exist in states',
7      path: "initialState"
8    }
9  ]
10}