stem_adapter_tests

Shared contract test suites used by Stem adapter packages to ensure brokers and result backends satisfy the core runtime contract. Intended as a dev dependency for packages like stem_redis, stem_postgres, and custom adapter implementations.

Install

Add as a dev dependency:

dart pub add --dev stem_adapter_tests

Then invoke the contract suites from your package tests:

import 'package:stem_adapter_tests/stem_adapter_tests.dart';

void main() {
  runBrokerContractTests(
    adapterName: 'MyBroker',
    factory: BrokerContractFactory(create: createBroker),
  );

  final storeFactory = WorkflowStoreContractFactory(
    create: createWorkflowStore,
  );

  runWorkflowStoreContractTests(
    adapterName: 'my-adapter',
    factory: storeFactory,
  );

  // Facade coverage validates the high-level workflow DSL across adapters.
  runWorkflowScriptFacadeTests(
    adapterName: 'my-adapter',
    factory: storeFactory,
  );
}

Future<WorkflowStore> createWorkflowStore(FakeWorkflowClock clock) async {
  return MyWorkflowStore(clock: clock);
}

The workflow store suite exercises durable watcher semantics (registerWatcher, resolveWatchers, and listWatchers) so adapters must capture event payloads atomically and expose waiting runs for operator tooling.

The factory receives a shared FakeWorkflowClock. Inject the same instance into your WorkflowRuntime during facade tests so both the runtime and store observe the same deterministic timeline.

Versioning

This package follows the same release cadence as the stem runtime.