@unlaxer/tramli-plugins 3.5.1 → 3.6.1

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,10 @@ 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>;
+    /** Run all analysis plugins and throw if any ERROR findings. For already-built definitions. */
+    analyzeAndValidate(definition: FlowDefinition<S>): void;
     /** 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,24 @@ 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;
+    }
+    /** Run all analysis plugins and throw if any ERROR findings. For already-built definitions. */
+    analyzeAndValidate(definition) {
+        const report = this.analyzeAll(definition);
+        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')}`);
+        }
+    }
     /** Apply all store plugins (wrapping in registration order). */
     applyStorePlugins(store) {
         let wrapped = store;

package/dist/cjs/index.d.ts

@@ -10,6 +10,7 @@ export { ReplayService, ProjectionReplayService } from './eventstore/replay-serv
 export { CompensationService } from './eventstore/compensation-service.js';
 export type { VersionedTransitionEvent, CompensationPlan, CompensationResolver, ProjectionReducer, } from './eventstore/types.js';
 export { ObservabilityEnginePlugin, InMemoryTelemetrySink } from './observability/observability-plugin.js';
+export { NoopTelemetrySink } from './observability/noop-telemetry-sink.js';
 export type { TelemetryEvent, TelemetrySink } from './observability/observability-plugin.js';
 export { RichResumeExecutor, RichResumeRuntimePlugin } from './resume/rich-resume.js';
 export type { RichResumeStatus, RichResumeResult } from './resume/rich-resume.js';
@@ -31,6 +32,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/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GuaranteedSubflowValidator = exports.ScenarioGenerationPlugin = exports.ScenarioTestPlugin = exports.allDefaultPolicies = exports.PolicyLintPlugin = exports.FlowDocumentationPlugin = exports.DocumentationPlugin = exports.DiagramGenerationPlugin = exports.DiagramPlugin = exports.flowSpec = exports.transitionSpec = exports.stateSpec = exports.HierarchyGenerationPlugin = exports.HierarchyCodeGenerator = exports.EntryExitCompiler = exports.IdempotencyRuntimePlugin = exports.IdempotentRichResumeExecutor = exports.InMemoryIdempotencyRegistry = exports.RichResumeRuntimePlugin = exports.RichResumeExecutor = exports.InMemoryTelemetrySink = exports.ObservabilityEnginePlugin = exports.CompensationService = exports.ProjectionReplayService = exports.ReplayService = exports.EventLogStoreDecorator = exports.EventLogStorePlugin = exports.AuditingFlowStore = exports.AuditStorePlugin = exports.PluginRegistry = exports.PluginReport = void 0;
+exports.GuaranteedSubflowValidator = exports.ScenarioGenerationPlugin = exports.ScenarioTestPlugin = exports.allDefaultPolicies = exports.PolicyLintPlugin = exports.FlowDocumentationPlugin = exports.DocumentationPlugin = exports.DiagramGenerationPlugin = exports.DiagramPlugin = exports.flowSpec = exports.transitionSpec = exports.stateSpec = exports.HierarchyGenerationPlugin = exports.HierarchyCodeGenerator = exports.EntryExitCompiler = exports.IdempotencyRuntimePlugin = exports.IdempotentRichResumeExecutor = exports.InMemoryIdempotencyRegistry = exports.RichResumeRuntimePlugin = exports.RichResumeExecutor = exports.NoopTelemetrySink = exports.InMemoryTelemetrySink = exports.ObservabilityEnginePlugin = exports.CompensationService = exports.ProjectionReplayService = exports.ReplayService = exports.EventLogStoreDecorator = exports.EventLogStorePlugin = exports.AuditingFlowStore = exports.AuditStorePlugin = exports.PluginRegistry = exports.PluginReport = void 0;
 // ── API framework ──
 var types_js_1 = require("./api/types.js");
 Object.defineProperty(exports, "PluginReport", { enumerable: true, get: function () { return types_js_1.PluginReport; } });
@@ -25,6 +25,8 @@ Object.defineProperty(exports, "CompensationService", { enumerable: true, get: f
 var observability_plugin_js_1 = require("./observability/observability-plugin.js");
 Object.defineProperty(exports, "ObservabilityEnginePlugin", { enumerable: true, get: function () { return observability_plugin_js_1.ObservabilityEnginePlugin; } });
 Object.defineProperty(exports, "InMemoryTelemetrySink", { enumerable: true, get: function () { return observability_plugin_js_1.InMemoryTelemetrySink; } });
+var noop_telemetry_sink_js_1 = require("./observability/noop-telemetry-sink.js");
+Object.defineProperty(exports, "NoopTelemetrySink", { enumerable: true, get: function () { return noop_telemetry_sink_js_1.NoopTelemetrySink; } });
 // ── Rich Resume ──
 var rich_resume_js_1 = require("./resume/rich-resume.js");
 Object.defineProperty(exports, "RichResumeExecutor", { enumerable: true, get: function () { return rich_resume_js_1.RichResumeExecutor; } });

package/dist/cjs/observability/noop-telemetry-sink.d.ts

@@ -0,0 +1,6 @@
+import type { TelemetrySink, TelemetryEvent } from './observability-plugin.js';
+/** No-op telemetry sink for benchmarking baseline. */
+export declare class NoopTelemetrySink implements TelemetrySink {
+    emit(_event: TelemetryEvent): void;
+    events(): readonly TelemetryEvent[];
+}

package/dist/cjs/observability/noop-telemetry-sink.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopTelemetrySink = void 0;
+/** No-op telemetry sink for benchmarking baseline. */
+class NoopTelemetrySink {
+    emit(_event) { }
+    events() { return []; }
+}
+exports.NoopTelemetrySink = NoopTelemetrySink;

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,10 @@ 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>;
+    /** Run all analysis plugins and throw if any ERROR findings. For already-built definitions. */
+    analyzeAndValidate(definition: FlowDefinition<S>): void;
     /** 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,24 @@ 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;
+    }
+    /** Run all analysis plugins and throw if any ERROR findings. For already-built definitions. */
+    analyzeAndValidate(definition) {
+        const report = this.analyzeAll(definition);
+        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')}`);
+        }
+    }
     /** Apply all store plugins (wrapping in registration order). */
     applyStorePlugins(store) {
         let wrapped = store;

package/dist/esm/index.d.ts

@@ -10,6 +10,7 @@ export { ReplayService, ProjectionReplayService } from './eventstore/replay-serv
 export { CompensationService } from './eventstore/compensation-service.js';
 export type { VersionedTransitionEvent, CompensationPlan, CompensationResolver, ProjectionReducer, } from './eventstore/types.js';
 export { ObservabilityEnginePlugin, InMemoryTelemetrySink } from './observability/observability-plugin.js';
+export { NoopTelemetrySink } from './observability/noop-telemetry-sink.js';
 export type { TelemetryEvent, TelemetrySink } from './observability/observability-plugin.js';
 export { RichResumeExecutor, RichResumeRuntimePlugin } from './resume/rich-resume.js';
 export type { RichResumeStatus, RichResumeResult } from './resume/rich-resume.js';
@@ -31,6 +32,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/index.js

@@ -11,6 +11,7 @@ export { ReplayService, ProjectionReplayService } from './eventstore/replay-serv
 export { CompensationService } from './eventstore/compensation-service.js';
 // ── Observability ──
 export { ObservabilityEnginePlugin, InMemoryTelemetrySink } from './observability/observability-plugin.js';
+export { NoopTelemetrySink } from './observability/noop-telemetry-sink.js';
 // ── Rich Resume ──
 export { RichResumeExecutor, RichResumeRuntimePlugin } from './resume/rich-resume.js';
 // ── Idempotency ──

package/dist/esm/observability/noop-telemetry-sink.d.ts

@@ -0,0 +1,6 @@
+import type { TelemetrySink, TelemetryEvent } from './observability-plugin.js';
+/** No-op telemetry sink for benchmarking baseline. */
+export declare class NoopTelemetrySink implements TelemetrySink {
+    emit(_event: TelemetryEvent): void;
+    events(): readonly TelemetryEvent[];
+}

package/dist/esm/observability/noop-telemetry-sink.js

@@ -0,0 +1,5 @@
+/** No-op telemetry sink for benchmarking baseline. */
+export class NoopTelemetrySink {
+    emit(_event) { }
+    events() { return []; }
+}

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.1",
   "description": "Plugin pack for tramli — audit, eventstore, observability, resume, idempotency, hierarchy, diagram, docs, lint, testing, subflow",
   "type": "module",
   "exports": {