dex-sdk 0.2.2

Strongly typed Rust SDK for Dex
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# Rust SDK integration tests

This suite mirrors `sdk-java/src/test/java/io/superdurable/dex/integ` in
idiomatic, strongly typed Rust. Each Java integration test and Workflow has a
corresponding Rust file with the same behavior and assertions. Stream coverage adds
one SDK-native test and Workflow.

| Java test | Rust module |
| --- | --- |
| `AnyCommandCombinationTest` | `any_command_combination_test.rs` |
| `BasicTest` | `basic_test.rs` |
| `ConditionalCompleteTest` | `conditional_complete_test.rs` |
| `InternalChannelTest` | `internal_channel_test.rs` |
| `NoStartStateTest` | `no_start_state_test.rs` |
| `PersistenceTest` | `persistence_test.rs` |
| `ResetTest` | `reset_test.rs` |
| `RpcTest` | `rpc_test.rs` |
| `RpcWithMemoTest` | `rpc_with_memo_test.rs` |
| `SearchFlowsTest` | `search_flows_test.rs` |
| `SignalTest` | `signal_test.rs` |
| `SkipWaitUntilTest` | `skip_wait_until_test.rs` |
| `StateOptionsOverrideTest` | `state_options_override_test.rs` |
| `StateOptionsTest` | `state_options_test.rs` |
| `StateRecoveryTest` | `state_recovery_test.rs` |
| `StreamTest` | `stream_test.rs` |
| `TimerTest` | `timer_test.rs` |
| `WorkflowUncompletedTest` | `workflow_uncompleted_test.rs` |

Run all scenarios against an isolated `dexcli dev` stack from `sdk-rust`:

```bash
./run-integration-tests.sh
```

To collect production `dex-sdk` coverage from only these integration targets,
install `cargo-llvm-cov` and run `./run-integration-tests.sh --coverage`.

Go's erased `ChannelDef` variant has no Rust counterpart: Rust keeps typed
`Channel<T>` values through registration, so the runtime channel scenario does
not need a second type-erased test. Go's pointer/value Flow cases likewise map
to one Rust ownership model and share one runtime scenario. Go-only behavioral
contracts live separately under `tests/cross_sdk` so they cannot obscure the
one-to-one Java suite.

## Error coverage

| Scenario | `SdkError` variant |
| --- | --- |
| Duplicate start | `FlowAlreadyStarted` |
| Missing describe, attribute read, or Flow wait | `FlowNotFound` |
| Missing or closed mutation/RPC | `FlowNotActive` |
| Worker handler failure | `WorkerInvocation` |
| Locking RPC contention | `RpcLockConflict` |
| Long-poll expiry | `LongPollTimeout` |
| Terminal Flow result | `FlowResult` for every terminal status |
| Durable SubFlow condition | Identity, all/any, reuse, reset, and continue-as-new |

Local contract tests also cover malformed rich details, fallible registration,
invalid Step-result worker metadata, user-owned Condition IDs, and map
introspection. Persistence integration covers singleton Attribute equality waits.