npm.io
1.0.0-alpha.113 • Published 4h agoCLI

@reventlessdev/reventless-gwt

Licence
Apache-2.0
Version
1.0.0-alpha.113
Deps
9
Size
944 kB
Vulns
0
Weekly
0
SummaryDependencyVersions

npm License: Apache-2.0 Docs

@reventlessdev/reventless-gwt

Alpha. APIs and on-disk formats can change without notice between releases. Pin exact versions and expect breaking changes.

Given-When-Then test DSLs and a CLI runner for slice-level testing in Reventless — a spec-driven, event-sourced CQRS framework written in ReScript. Each DSL wraps one kind of framework component (aggregate, slice, projection, automation, translation, flow) in a declarative triple-A (given / when / then) surface, and the reventless-dev CLI discovers and runs those tests across a workspace.

What it provides

ReScript test DSLs

Every component kind has a functor that produces the same describe / test / given* / when* / then* combinator surface:

  • Behavior_GWT — event-sourced behavior tests for aggregates and StateChangeSlices (givenEvents → whenCmd → thenEmits), including DCB append-condition assertions.
  • Projection_GWT / MultiSourceProjection_GWT — single-source (StateViewSlice) and multi-source (ReadModel) projection tests.
  • Query_GWT — the read side: which query patterns the projected state must support (indexes, sub-ids, resolvers).
  • Automation_GWT — AutomationSlice reaction tests (event → command).
  • InboundTranslation_GWT / OutboundTranslation_GWT / EventMapping_GWT / Mapping_GWT — cross-component translation tests.
  • Flow_GWT — cross-slice / end-to-end tests that thread one event log through a chain of slices, verifying the wiring between tiles of an Event Modeling board.
CLI runner

The package installs the reventless-dev command (alias: reventless-gwt):

reventless-dev run [--format=<fmt>] [--filter=<id>] [--stream] [--watch] [path...]
reventless-dev discover [--format=vscode] [path...]
reventless-dev watch [--format=<fmt>] [--filter=<id>] [path...]
reventless-dev platform [--format=vscode] [--backend=<b>] [--ui-ports] [path...]

It walks a workspace to discover compiled GWT tests, runs them, and reports through pluggable formatters — human, json, tap, junit, and vscode (NDJSON). It also emits the domain graph / component inventory used by editor surfaces and can launch a local platform for integration runs.

Where it fits

reventless-gwt builds on @reventlessdev/reventless-core and @reventlessdev/reventless-spec: the DSLs test the same component specs you write against core, with no storage or cloud adapter required. Its --format=vscode output speaks the @reventlessdev/reventless-domain-protocol NDJSON contract, so the same runs drive the VS Code extension's test tree and domain views.

Install

pnpm add -D @reventlessdev/reventless-gwt

Register it as a ReScript dependency in rescript.json:

{
  "dependencies": ["@reventlessdev/reventless-gwt"]
}

Requires ReScript ^12.3.0 (peer dependency). Run the CLI with pnpm exec reventless-dev run (or add it to a package script).

Links

License

Apache-2.0