@unlaxer/tramli 1.5.3 → 1.6.0

package/dist/cjs/flow-engine.js

@@ -26,7 +26,7 @@ class FlowEngine {
         return flow;
     }
     async resumeAndExecute(flowId, definition, externalData) {
-        const flow = this.store.loadForUpdate(flowId);
+        const flow = this.store.loadForUpdate(flowId, definition);
         if (!flow)
             throw new flow_error_js_1.FlowError('FLOW_NOT_FOUND', `Flow ${flowId} not found or already completed`);
         if (externalData) {
@@ -63,9 +63,9 @@ class FlowEngine {
                         flow.transitionTo(transition.to);
                         this.store.recordTransition(flow.id, from, transition.to, guard.name, flow.context);
                     }
-                    catch {
+                    catch (e) {
                         flow.context.restoreFrom(backup);
-                        this.handleError(flow, currentState);
+                        this.handleError(flow, currentState, e instanceof Error ? e : new Error(String(e)));
                         this.store.save(flow);
                         return flow;
                     }
@@ -140,9 +140,9 @@ class FlowEngine {
                     this.store.recordTransition(flow.id, from, target, `${branch.name}:${label}`, flow.context);
                 }
             }
-            catch {
+            catch (e) {
                 flow.context.restoreFrom(backup);
-                this.handleError(flow, flow.currentState);
+                this.handleError(flow, flow.currentState, e instanceof Error ? e : new Error(String(e)));
                 return;
             }
             depth++;
@@ -225,7 +225,9 @@ class FlowEngine {
         this.store.save(parentFlow);
         return parentFlow;
     }
-    handleError(flow, fromState) {
+    handleError(flow, fromState, cause) {
+        if (cause)
+            flow.setLastError(`${cause.constructor.name}: ${cause.message}`);
         const errorTarget = flow.definition.errorTransitions.get(fromState);
         if (errorTarget) {
             const from = flow.currentState;

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

@@ -12,6 +12,7 @@ export declare class FlowInstance<S extends string> {
     readonly expiresAt: Date;
     private _exitState;
     private _activeSubFlow;
+    private _lastError;
     constructor(id: string, sessionId: string, definition: FlowDefinition<S>, context: FlowContext, currentState: S, expiresAt: Date);
     /**
      * Restore a FlowInstance from persisted state.
@@ -24,6 +25,8 @@ export declare class FlowInstance<S extends string> {
     get exitState(): string | null;
     get isCompleted(): boolean;
     get activeSubFlow(): FlowInstance<any> | null;
+    /** Last error message (set when a processor throws and error transition fires). */
+    get lastError(): string | null;
     /** State path from root to deepest active sub-flow. */
     statePath(): string[];
     /** State path as slash-separated string. */
@@ -41,4 +44,5 @@ export declare class FlowInstance<S extends string> {
     /** @internal */ complete(exitState: string): void;
     /** @internal */ setVersion(version: number): void;
     /** @internal */ setActiveSubFlow(sub: FlowInstance<any> | null): void;
+    /** @internal */ setLastError(error: string | null): void;
 }

package/dist/cjs/flow-instance.js

@@ -13,6 +13,7 @@ class FlowInstance {
     expiresAt;
     _exitState;
     _activeSubFlow = null;
+    _lastError = null;
     constructor(id, sessionId, definition, context, currentState, expiresAt) {
         this.id = id;
         this.sessionId = sessionId;
@@ -50,6 +51,8 @@ class FlowInstance {
     get exitState() { return this._exitState; }
     get isCompleted() { return this._exitState !== null; }
     get activeSubFlow() { return this._activeSubFlow; }
+    /** Last error message (set when a processor throws and error transition fires). */
+    get lastError() { return this._lastError; }
     /** State path from root to deepest active sub-flow. */
     statePath() {
         const path = [this._currentState];
@@ -100,5 +103,6 @@ class FlowInstance {
     /** @internal */ complete(exitState) { this._exitState = exitState; }
     /** @internal */ setVersion(version) { this._version = version; }
     /** @internal */ setActiveSubFlow(sub) { this._activeSubFlow = sub; }
+    /** @internal */ setLastError(error) { this._lastError = error; }
 }
 exports.FlowInstance = FlowInstance;

package/dist/cjs/in-memory-flow-store.d.ts

@@ -12,7 +12,7 @@ export declare class InMemoryFlowStore {
     private flows;
     private _transitionLog;
     create(flow: FlowInstance<any>): void;
-    loadForUpdate<S extends string>(flowId: string): FlowInstance<S> | undefined;
+    loadForUpdate<S extends string>(flowId: string, _definition?: any): FlowInstance<S> | undefined;
     save(flow: FlowInstance<any>): void;
     recordTransition(flowId: string, from: string | null, to: string, trigger: string, _ctx: FlowContext): void;
     get transitionLog(): readonly TransitionRecord[];

package/dist/cjs/in-memory-flow-store.js

@@ -7,7 +7,7 @@ class InMemoryFlowStore {
     create(flow) {
         this.flows.set(flow.id, flow);
     }
-    loadForUpdate(flowId) {
+    loadForUpdate(flowId, _definition) {
         const flow = this.flows.get(flowId);
         if (!flow || flow.isCompleted)
             return undefined;

package/dist/esm/flow-engine.js

@@ -23,7 +23,7 @@ export class FlowEngine {
         return flow;
     }
     async resumeAndExecute(flowId, definition, externalData) {
-        const flow = this.store.loadForUpdate(flowId);
+        const flow = this.store.loadForUpdate(flowId, definition);
         if (!flow)
             throw new FlowError('FLOW_NOT_FOUND', `Flow ${flowId} not found or already completed`);
         if (externalData) {
@@ -60,9 +60,9 @@ export class FlowEngine {
                         flow.transitionTo(transition.to);
                         this.store.recordTransition(flow.id, from, transition.to, guard.name, flow.context);
                     }
-                    catch {
+                    catch (e) {
                         flow.context.restoreFrom(backup);
-                        this.handleError(flow, currentState);
+                        this.handleError(flow, currentState, e instanceof Error ? e : new Error(String(e)));
                         this.store.save(flow);
                         return flow;
                     }
@@ -137,9 +137,9 @@ export class FlowEngine {
                     this.store.recordTransition(flow.id, from, target, `${branch.name}:${label}`, flow.context);
                 }
             }
-            catch {
+            catch (e) {
                 flow.context.restoreFrom(backup);
-                this.handleError(flow, flow.currentState);
+                this.handleError(flow, flow.currentState, e instanceof Error ? e : new Error(String(e)));
                 return;
             }
             depth++;
@@ -222,7 +222,9 @@ export class FlowEngine {
         this.store.save(parentFlow);
         return parentFlow;
     }
-    handleError(flow, fromState) {
+    handleError(flow, fromState, cause) {
+        if (cause)
+            flow.setLastError(`${cause.constructor.name}: ${cause.message}`);
         const errorTarget = flow.definition.errorTransitions.get(fromState);
         if (errorTarget) {
             const from = flow.currentState;

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

@@ -12,6 +12,7 @@ export declare class FlowInstance<S extends string> {
     readonly expiresAt: Date;
     private _exitState;
     private _activeSubFlow;
+    private _lastError;
     constructor(id: string, sessionId: string, definition: FlowDefinition<S>, context: FlowContext, currentState: S, expiresAt: Date);
     /**
      * Restore a FlowInstance from persisted state.
@@ -24,6 +25,8 @@ export declare class FlowInstance<S extends string> {
     get exitState(): string | null;
     get isCompleted(): boolean;
     get activeSubFlow(): FlowInstance<any> | null;
+    /** Last error message (set when a processor throws and error transition fires). */
+    get lastError(): string | null;
     /** State path from root to deepest active sub-flow. */
     statePath(): string[];
     /** State path as slash-separated string. */
@@ -41,4 +44,5 @@ export declare class FlowInstance<S extends string> {
     /** @internal */ complete(exitState: string): void;
     /** @internal */ setVersion(version: number): void;
     /** @internal */ setActiveSubFlow(sub: FlowInstance<any> | null): void;
+    /** @internal */ setLastError(error: string | null): void;
 }

package/dist/esm/flow-instance.js

@@ -10,6 +10,7 @@ export class FlowInstance {
     expiresAt;
     _exitState;
     _activeSubFlow = null;
+    _lastError = null;
     constructor(id, sessionId, definition, context, currentState, expiresAt) {
         this.id = id;
         this.sessionId = sessionId;
@@ -47,6 +48,8 @@ export class FlowInstance {
     get exitState() { return this._exitState; }
     get isCompleted() { return this._exitState !== null; }
     get activeSubFlow() { return this._activeSubFlow; }
+    /** Last error message (set when a processor throws and error transition fires). */
+    get lastError() { return this._lastError; }
     /** State path from root to deepest active sub-flow. */
     statePath() {
         const path = [this._currentState];
@@ -97,4 +100,5 @@ export class FlowInstance {
     /** @internal */ complete(exitState) { this._exitState = exitState; }
     /** @internal */ setVersion(version) { this._version = version; }
     /** @internal */ setActiveSubFlow(sub) { this._activeSubFlow = sub; }
+    /** @internal */ setLastError(error) { this._lastError = error; }
 }

package/dist/esm/in-memory-flow-store.d.ts

@@ -12,7 +12,7 @@ export declare class InMemoryFlowStore {
     private flows;
     private _transitionLog;
     create(flow: FlowInstance<any>): void;
-    loadForUpdate<S extends string>(flowId: string): FlowInstance<S> | undefined;
+    loadForUpdate<S extends string>(flowId: string, _definition?: any): FlowInstance<S> | undefined;
     save(flow: FlowInstance<any>): void;
     recordTransition(flowId: string, from: string | null, to: string, trigger: string, _ctx: FlowContext): void;
     get transitionLog(): readonly TransitionRecord[];

package/dist/esm/in-memory-flow-store.js

@@ -4,7 +4,7 @@ export class InMemoryFlowStore {
     create(flow) {
         this.flows.set(flow.id, flow);
     }
-    loadForUpdate(flowId) {
+    loadForUpdate(flowId, _definition) {
         const flow = this.flows.get(flowId);
         if (!flow || flow.isCompleted)
             return undefined;

package/package.json

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