@unlaxer/tramli 1.12.0 → 1.14.0

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

@@ -1,6 +1,8 @@
 import type { FlowDefinition } from './flow-definition.js';
 import { FlowInstance } from './flow-instance.js';
 import type { InMemoryFlowStore } from './in-memory-flow-store.js';
+/** Default max auto-chain depth. Override via constructor options. */
+export declare const DEFAULT_MAX_CHAIN_DEPTH = 10;
 /** Log entry types for tramli's pluggable logger API. */
 export interface TransitionLogEntry {
     flowId: string;
@@ -24,11 +26,13 @@ export interface ErrorLogEntry {
 export declare class FlowEngine {
     private readonly store;
     private readonly strictMode;
+    private readonly maxChainDepth;
     private transitionLogger?;
     private stateLogger?;
     private errorLogger?;
     constructor(store: InMemoryFlowStore, options?: {
         strictMode?: boolean;
+        maxChainDepth?: number;
     });
     setTransitionLogger(logger: ((entry: TransitionLogEntry) => void) | null): void;
     setStateLogger(logger: ((entry: StateLogEntry) => void) | null): void;

package/dist/cjs/flow-engine.js

@@ -1,19 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FlowEngine = void 0;
+exports.FlowEngine = exports.DEFAULT_MAX_CHAIN_DEPTH = void 0;
 const flow_context_js_1 = require("./flow-context");
 const flow_instance_js_1 = require("./flow-instance");
 const flow_error_js_1 = require("./flow-error");
-const MAX_CHAIN_DEPTH = 10;
+/** Default max auto-chain depth. Override via constructor options. */
+exports.DEFAULT_MAX_CHAIN_DEPTH = 10;
 class FlowEngine {
     store;
     strictMode;
+    maxChainDepth;
     transitionLogger;
     stateLogger;
     errorLogger;
     constructor(store, options) {
         this.store = store;
         this.strictMode = options?.strictMode ?? false;
+        this.maxChainDepth = options?.maxChainDepth ?? exports.DEFAULT_MAX_CHAIN_DEPTH;
     }
     setTransitionLogger(logger) {
         this.transitionLogger = logger ?? undefined;
@@ -116,7 +119,7 @@ class FlowEngine {
     }
     async executeAutoChain(flow) {
         let depth = 0;
-        while (depth < MAX_CHAIN_DEPTH) {
+        while (depth < this.maxChainDepth) {
             const current = flow.currentState;
             if (flow.definition.stateConfig[current].terminal) {
                 flow.complete(current);
@@ -168,7 +171,7 @@ class FlowEngine {
             }
             depth++;
         }
-        if (depth >= MAX_CHAIN_DEPTH)
+        if (depth >= this.maxChainDepth)
             throw flow_error_js_1.FlowError.maxChainDepth();
     }
     async executeSubFlow(parentFlow, subFlowTransition) {

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

@@ -1,10 +1,15 @@
+export type FlowErrorType = 'BUSINESS' | 'SYSTEM' | 'RETRYABLE' | 'FATAL';
 export declare class FlowError extends Error {
     readonly code: string;
+    /** Error type classification for retry/recovery strategy. */
+    errorType?: FlowErrorType;
     /** Types that were available in context when the error occurred. */
     availableTypes?: Set<string>;
     /** Types that were expected but missing (if applicable). */
     missingTypes?: Set<string>;
     constructor(code: string, message: string);
+    /** Attach error type classification. */
+    withErrorType(type: FlowErrorType): this;
     /** Attach context snapshot to this error. */
     withContextSnapshot(available: Set<string>, missing: Set<string>): this;
     static invalidTransition(from: string, to: string): FlowError;

package/dist/cjs/flow-error.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlowError = void 0;
 class FlowError extends Error {
     code;
+    /** Error type classification for retry/recovery strategy. */
+    errorType;
     /** Types that were available in context when the error occurred. */
     availableTypes;
     /** Types that were expected but missing (if applicable). */
@@ -12,6 +14,11 @@ class FlowError extends Error {
         this.code = code;
         this.name = 'FlowError';
     }
+    /** Attach error type classification. */
+    withErrorType(type) {
+        this.errorType = type;
+        return this;
+    }
     /** Attach context snapshot to this error. */
     withContextSnapshot(available, missing) {
         this.availableTypes = available;

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

@@ -1,6 +1,8 @@
 import type { FlowDefinition } from './flow-definition.js';
 import { FlowInstance } from './flow-instance.js';
 import type { InMemoryFlowStore } from './in-memory-flow-store.js';
+/** Default max auto-chain depth. Override via constructor options. */
+export declare const DEFAULT_MAX_CHAIN_DEPTH = 10;
 /** Log entry types for tramli's pluggable logger API. */
 export interface TransitionLogEntry {
     flowId: string;
@@ -24,11 +26,13 @@ export interface ErrorLogEntry {
 export declare class FlowEngine {
     private readonly store;
     private readonly strictMode;
+    private readonly maxChainDepth;
     private transitionLogger?;
     private stateLogger?;
     private errorLogger?;
     constructor(store: InMemoryFlowStore, options?: {
         strictMode?: boolean;
+        maxChainDepth?: number;
     });
     setTransitionLogger(logger: ((entry: TransitionLogEntry) => void) | null): void;
     setStateLogger(logger: ((entry: StateLogEntry) => void) | null): void;

package/dist/esm/flow-engine.js

@@ -1,16 +1,19 @@
 import { FlowContext } from './flow-context.js';
 import { FlowInstance } from './flow-instance.js';
 import { FlowError } from './flow-error.js';
-const MAX_CHAIN_DEPTH = 10;
+/** Default max auto-chain depth. Override via constructor options. */
+export const DEFAULT_MAX_CHAIN_DEPTH = 10;
 export class FlowEngine {
     store;
     strictMode;
+    maxChainDepth;
     transitionLogger;
     stateLogger;
     errorLogger;
     constructor(store, options) {
         this.store = store;
         this.strictMode = options?.strictMode ?? false;
+        this.maxChainDepth = options?.maxChainDepth ?? DEFAULT_MAX_CHAIN_DEPTH;
     }
     setTransitionLogger(logger) {
         this.transitionLogger = logger ?? undefined;
@@ -113,7 +116,7 @@ export class FlowEngine {
     }
     async executeAutoChain(flow) {
         let depth = 0;
-        while (depth < MAX_CHAIN_DEPTH) {
+        while (depth < this.maxChainDepth) {
             const current = flow.currentState;
             if (flow.definition.stateConfig[current].terminal) {
                 flow.complete(current);
@@ -165,7 +168,7 @@ export class FlowEngine {
             }
             depth++;
         }
-        if (depth >= MAX_CHAIN_DEPTH)
+        if (depth >= this.maxChainDepth)
             throw FlowError.maxChainDepth();
     }
     async executeSubFlow(parentFlow, subFlowTransition) {

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

@@ -1,10 +1,15 @@
+export type FlowErrorType = 'BUSINESS' | 'SYSTEM' | 'RETRYABLE' | 'FATAL';
 export declare class FlowError extends Error {
     readonly code: string;
+    /** Error type classification for retry/recovery strategy. */
+    errorType?: FlowErrorType;
     /** Types that were available in context when the error occurred. */
     availableTypes?: Set<string>;
     /** Types that were expected but missing (if applicable). */
     missingTypes?: Set<string>;
     constructor(code: string, message: string);
+    /** Attach error type classification. */
+    withErrorType(type: FlowErrorType): this;
     /** Attach context snapshot to this error. */
     withContextSnapshot(available: Set<string>, missing: Set<string>): this;
     static invalidTransition(from: string, to: string): FlowError;

package/dist/esm/flow-error.js

@@ -1,5 +1,7 @@
 export class FlowError extends Error {
     code;
+    /** Error type classification for retry/recovery strategy. */
+    errorType;
     /** Types that were available in context when the error occurred. */
     availableTypes;
     /** Types that were expected but missing (if applicable). */
@@ -9,6 +11,11 @@ export class FlowError extends Error {
         this.code = code;
         this.name = 'FlowError';
     }
+    /** Attach error type classification. */
+    withErrorType(type) {
+        this.errorType = type;
+        return this;
+    }
     /** Attach context snapshot to this error. */
     withContextSnapshot(available, missing) {
         this.availableTypes = available;

package/package.json

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