@unlaxer/tramli-plugins 3.5.1 → 3.6.0

package/dist/cjs/api/plugin-registry.d.ts

@@ -1,4 +1,4 @@
-import type { FlowDefinition, FlowEngine } from '@unlaxer/tramli';
+import type { FlowDefinition, FlowEngine, Builder } from '@unlaxer/tramli';
 import type { FlowPlugin } from './types.js';
 import { PluginReport } from './types.js';
 /**
@@ -10,6 +10,8 @@ export declare class PluginRegistry<S extends string> {
     register(plugin: FlowPlugin): this;
     /** Run all analysis plugins against a FlowDefinition. */
     analyzeAll(definition: FlowDefinition<S>): PluginReport;
+    /** Build a FlowDefinition and run all analysis plugins. Throws if any ERROR findings. */
+    buildAndAnalyze(builder: Builder<S>): FlowDefinition<S>;
     /** Apply all store plugins (wrapping in registration order). */
     applyStorePlugins(store: any): any;
     /** Install all engine plugins. */

package/dist/cjs/api/plugin-registry.js

@@ -22,6 +22,16 @@ class PluginRegistry {
         }
         return report;
     }
+    /** Build a FlowDefinition and run all analysis plugins. Throws if any ERROR findings. */
+    buildAndAnalyze(builder) {
+        const def = builder.build();
+        const report = this.analyzeAll(def);
+        const errors = report.findings().filter(f => f.severity === 'ERROR');
+        if (errors.length > 0) {
+            throw new Error(`Analysis errors:\n${errors.map(e => `  [${e.pluginId}] ${e.message}`).join('\n')}`);
+        }
+        return def;
+    }
     /** Apply all store plugins (wrapping in registration order). */
     applyStorePlugins(store) {
         let wrapped = store;

package/dist/cjs/index.d.ts

@@ -31,6 +31,7 @@ export { PolicyLintPlugin } from './lint/policy-lint-plugin.js';
 export { allDefaultPolicies } from './lint/default-flow-policies.js';
 export type { FlowPolicy } from './lint/types.js';
 export { ScenarioTestPlugin } from './testing/scenario-test-plugin.js';
+export type { TestFramework } from './testing/scenario-test-plugin.js';
 export { ScenarioGenerationPlugin } from './testing/scenario-generation-plugin.js';
 export type { FlowScenario, FlowTestPlan, ScenarioKind } from './testing/types.js';
 export { GuaranteedSubflowValidator } from './subflow/guaranteed-subflow-validator.js';

package/dist/cjs/testing/scenario-test-plugin.d.ts

@@ -1,9 +1,16 @@
 import type { FlowDefinition } from '@unlaxer/tramli';
 import type { FlowTestPlan } from './types.js';
+export type TestFramework = 'vitest' | 'jest';
 /**
  * Generates BDD-style test scenarios from a flow definition.
  * Covers happy paths, error transitions, guard rejections, and timeout expiry.
  */
 export declare class ScenarioTestPlugin {
+    /**
+     * Generate executable test code from a flow definition.
+     * Produces a string of vitest/jest test code that validates transitions
+     * against the definition's structure (no FlowEngine required).
+     */
+    generateCode<S extends string>(definition: FlowDefinition<S>, framework?: TestFramework): string;
     generate<S extends string>(definition: FlowDefinition<S>): FlowTestPlan;
 }

package/dist/cjs/testing/scenario-test-plugin.js

@@ -6,6 +6,68 @@ exports.ScenarioTestPlugin = void 0;
  * Covers happy paths, error transitions, guard rejections, and timeout expiry.
  */
 class ScenarioTestPlugin {
+    /**
+     * Generate executable test code from a flow definition.
+     * Produces a string of vitest/jest test code that validates transitions
+     * against the definition's structure (no FlowEngine required).
+     */
+    generateCode(definition, framework = 'vitest') {
+        const plan = this.generate(definition);
+        const lines = [];
+        const imp = framework === 'vitest' ? "import { describe, it, expect } from 'vitest';" : '';
+        if (imp)
+            lines.push(imp);
+        lines.push('');
+        lines.push(`describe('${definition.name} scenarios', () => {`);
+        for (const scenario of plan.scenarios) {
+            lines.push(`  it('${scenario.name}', () => {`);
+            for (const step of scenario.steps) {
+                lines.push(`    // ${step}`);
+            }
+            // Add assertion based on scenario kind
+            switch (scenario.kind) {
+                case 'happy': {
+                    const fromMatch = scenario.steps[0]?.match(/given flow in (\S+)/);
+                    const toMatch = scenario.steps[scenario.steps.length - 1]?.match(/then flow reaches (\S+)/);
+                    if (fromMatch && toMatch) {
+                        const from = fromMatch[1];
+                        const to = toMatch[1];
+                        lines.push(`    const transitions = definition.transitionsFrom('${from}');`);
+                        lines.push(`    expect(transitions.some(t => t.to === '${to}')).toBe(true);`);
+                    }
+                    break;
+                }
+                case 'error': {
+                    const fromMatch = scenario.steps[0]?.match(/given flow in (\S+)/);
+                    const toMatch = scenario.steps[scenario.steps.length - 1]?.match(/then flow transitions to (\S+)/);
+                    if (fromMatch && toMatch) {
+                        lines.push(`    expect(definition.errorTransitions.get('${fromMatch[1]}')).toBe('${toMatch[1]}');`);
+                    }
+                    break;
+                }
+                case 'guard_rejection': {
+                    const guardMatch = scenario.steps[1]?.match(/when guard (\S+) rejects/);
+                    if (guardMatch) {
+                        lines.push(`    expect(definition.maxGuardRetries).toBeGreaterThan(0);`);
+                    }
+                    break;
+                }
+                case 'timeout': {
+                    const fromMatch = scenario.steps[0]?.match(/given flow in (\S+)/);
+                    if (fromMatch) {
+                        lines.push(`    const t = definition.transitionsFrom('${fromMatch[1]}').find(t => t.timeout != null);`);
+                        lines.push(`    expect(t).toBeDefined();`);
+                    }
+                    break;
+                }
+            }
+            lines.push('  });');
+            lines.push('');
+        }
+        lines.push('});');
+        lines.push('');
+        return lines.join('\n');
+    }
     generate(definition) {
         const scenarios = [];
         // Happy path scenarios from transitions

package/dist/esm/api/plugin-registry.d.ts

@@ -1,4 +1,4 @@
-import type { FlowDefinition, FlowEngine } from '@unlaxer/tramli';
+import type { FlowDefinition, FlowEngine, Builder } from '@unlaxer/tramli';
 import type { FlowPlugin } from './types.js';
 import { PluginReport } from './types.js';
 /**
@@ -10,6 +10,8 @@ export declare class PluginRegistry<S extends string> {
     register(plugin: FlowPlugin): this;
     /** Run all analysis plugins against a FlowDefinition. */
     analyzeAll(definition: FlowDefinition<S>): PluginReport;
+    /** Build a FlowDefinition and run all analysis plugins. Throws if any ERROR findings. */
+    buildAndAnalyze(builder: Builder<S>): FlowDefinition<S>;
     /** Apply all store plugins (wrapping in registration order). */
     applyStorePlugins(store: any): any;
     /** Install all engine plugins. */

package/dist/esm/api/plugin-registry.js

@@ -19,6 +19,16 @@ export class PluginRegistry {
         }
         return report;
     }
+    /** Build a FlowDefinition and run all analysis plugins. Throws if any ERROR findings. */
+    buildAndAnalyze(builder) {
+        const def = builder.build();
+        const report = this.analyzeAll(def);
+        const errors = report.findings().filter(f => f.severity === 'ERROR');
+        if (errors.length > 0) {
+            throw new Error(`Analysis errors:\n${errors.map(e => `  [${e.pluginId}] ${e.message}`).join('\n')}`);
+        }
+        return def;
+    }
     /** Apply all store plugins (wrapping in registration order). */
     applyStorePlugins(store) {
         let wrapped = store;

package/dist/esm/index.d.ts

@@ -31,6 +31,7 @@ export { PolicyLintPlugin } from './lint/policy-lint-plugin.js';
 export { allDefaultPolicies } from './lint/default-flow-policies.js';
 export type { FlowPolicy } from './lint/types.js';
 export { ScenarioTestPlugin } from './testing/scenario-test-plugin.js';
+export type { TestFramework } from './testing/scenario-test-plugin.js';
 export { ScenarioGenerationPlugin } from './testing/scenario-generation-plugin.js';
 export type { FlowScenario, FlowTestPlan, ScenarioKind } from './testing/types.js';
 export { GuaranteedSubflowValidator } from './subflow/guaranteed-subflow-validator.js';

package/dist/esm/testing/scenario-test-plugin.d.ts

@@ -1,9 +1,16 @@
 import type { FlowDefinition } from '@unlaxer/tramli';
 import type { FlowTestPlan } from './types.js';
+export type TestFramework = 'vitest' | 'jest';
 /**
  * Generates BDD-style test scenarios from a flow definition.
  * Covers happy paths, error transitions, guard rejections, and timeout expiry.
  */
 export declare class ScenarioTestPlugin {
+    /**
+     * Generate executable test code from a flow definition.
+     * Produces a string of vitest/jest test code that validates transitions
+     * against the definition's structure (no FlowEngine required).
+     */
+    generateCode<S extends string>(definition: FlowDefinition<S>, framework?: TestFramework): string;
     generate<S extends string>(definition: FlowDefinition<S>): FlowTestPlan;
 }

package/dist/esm/testing/scenario-test-plugin.js

@@ -3,6 +3,68 @@
  * Covers happy paths, error transitions, guard rejections, and timeout expiry.
  */
 export class ScenarioTestPlugin {
+    /**
+     * Generate executable test code from a flow definition.
+     * Produces a string of vitest/jest test code that validates transitions
+     * against the definition's structure (no FlowEngine required).
+     */
+    generateCode(definition, framework = 'vitest') {
+        const plan = this.generate(definition);
+        const lines = [];
+        const imp = framework === 'vitest' ? "import { describe, it, expect } from 'vitest';" : '';
+        if (imp)
+            lines.push(imp);
+        lines.push('');
+        lines.push(`describe('${definition.name} scenarios', () => {`);
+        for (const scenario of plan.scenarios) {
+            lines.push(`  it('${scenario.name}', () => {`);
+            for (const step of scenario.steps) {
+                lines.push(`    // ${step}`);
+            }
+            // Add assertion based on scenario kind
+            switch (scenario.kind) {
+                case 'happy': {
+                    const fromMatch = scenario.steps[0]?.match(/given flow in (\S+)/);
+                    const toMatch = scenario.steps[scenario.steps.length - 1]?.match(/then flow reaches (\S+)/);
+                    if (fromMatch && toMatch) {
+                        const from = fromMatch[1];
+                        const to = toMatch[1];
+                        lines.push(`    const transitions = definition.transitionsFrom('${from}');`);
+                        lines.push(`    expect(transitions.some(t => t.to === '${to}')).toBe(true);`);
+                    }
+                    break;
+                }
+                case 'error': {
+                    const fromMatch = scenario.steps[0]?.match(/given flow in (\S+)/);
+                    const toMatch = scenario.steps[scenario.steps.length - 1]?.match(/then flow transitions to (\S+)/);
+                    if (fromMatch && toMatch) {
+                        lines.push(`    expect(definition.errorTransitions.get('${fromMatch[1]}')).toBe('${toMatch[1]}');`);
+                    }
+                    break;
+                }
+                case 'guard_rejection': {
+                    const guardMatch = scenario.steps[1]?.match(/when guard (\S+) rejects/);
+                    if (guardMatch) {
+                        lines.push(`    expect(definition.maxGuardRetries).toBeGreaterThan(0);`);
+                    }
+                    break;
+                }
+                case 'timeout': {
+                    const fromMatch = scenario.steps[0]?.match(/given flow in (\S+)/);
+                    if (fromMatch) {
+                        lines.push(`    const t = definition.transitionsFrom('${fromMatch[1]}').find(t => t.timeout != null);`);
+                        lines.push(`    expect(t).toBeDefined();`);
+                    }
+                    break;
+                }
+            }
+            lines.push('  });');
+            lines.push('');
+        }
+        lines.push('});');
+        lines.push('');
+        return lines.join('\n');
+    }
     generate(definition) {
         const scenarios = [];
         // Happy path scenarios from transitions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlaxer/tramli-plugins",
-  "version": "3.5.1",
+  "version": "3.6.0",
   "description": "Plugin pack for tramli — audit, eventstore, observability, resume, idempotency, hierarchy, diagram, docs, lint, testing, subflow",
   "type": "module",
   "exports": {