@unlaxer/tramli 1.10.0 → 1.11.0

package/dist/cjs/flow-definition.d.ts

@@ -11,6 +11,7 @@ export declare class FlowDefinition<S extends string> {
     readonly initialState: S | null;
     readonly terminalStates: Set<S>;
     readonly dataFlowGraph: DataFlowGraph<S> | null;
+    readonly warnings: string[];
     private constructor();
     transitionsFrom(state: S): Transition<S>[];
     externalFrom(state: S): Transition<S> | undefined;

package/dist/cjs/flow-definition.js

@@ -13,6 +13,7 @@ class FlowDefinition {
     initialState;
     terminalStates;
     dataFlowGraph;
+    warnings;
     constructor(name, stateConfig, ttl, maxGuardRetries, transitions, errorTransitions) {
         this.name = name;
         this.stateConfig = stateConfig;
@@ -143,6 +144,14 @@ class Builder {
         result.dataFlowGraph = null;
         this.validate(result);
         result.dataFlowGraph = data_flow_graph_js_1.DataFlowGraph.build(result, this.initiallyAvailableKeys);
+        // Build warnings
+        const warnings = [];
+        const perpetual = terminals.size === 0;
+        const hasExternal = this.transitions.some(t => t.type === 'external');
+        if (perpetual && hasExternal) {
+            warnings.push(`Perpetual flow '${this.name}' has External transitions — ensure events are always delivered to avoid deadlock (liveness risk)`);
+        }
+        result.warnings = warnings;
         return result;
     }
     validate(def) {

package/dist/esm/flow-definition.d.ts

@@ -11,6 +11,7 @@ export declare class FlowDefinition<S extends string> {
     readonly initialState: S | null;
     readonly terminalStates: Set<S>;
     readonly dataFlowGraph: DataFlowGraph<S> | null;
+    readonly warnings: string[];
     private constructor();
     transitionsFrom(state: S): Transition<S>[];
     externalFrom(state: S): Transition<S> | undefined;

package/dist/esm/flow-definition.js

@@ -10,6 +10,7 @@ export class FlowDefinition {
     initialState;
     terminalStates;
     dataFlowGraph;
+    warnings;
     constructor(name, stateConfig, ttl, maxGuardRetries, transitions, errorTransitions) {
         this.name = name;
         this.stateConfig = stateConfig;
@@ -139,6 +140,14 @@ export class Builder {
         result.dataFlowGraph = null;
         this.validate(result);
         result.dataFlowGraph = DataFlowGraph.build(result, this.initiallyAvailableKeys);
+        // Build warnings
+        const warnings = [];
+        const perpetual = terminals.size === 0;
+        const hasExternal = this.transitions.some(t => t.type === 'external');
+        if (perpetual && hasExternal) {
+            warnings.push(`Perpetual flow '${this.name}' has External transitions — ensure events are always delivered to avoid deadlock (liveness risk)`);
+        }
+        result.warnings = warnings;
         return result;
     }
     validate(def) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlaxer/tramli",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Constrained flow engine — state machines that prevent invalid transitions at build time",
   "type": "module",
   "exports": {