gun-rs 1.0.4

A realtime, decentralized, offline-first, graph data synchronization engine (Rust port)
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# Integration Tests Summary


## Test Status


Since we cannot run the tests directly (Rust/Cargo not available in current environment), here's what the tests are designed to verify:

## Tests Created


### ✅ `test_relay_put_get`

- **Purpose**: Verify basic put/get operations work with relay server
- **What it tests**: Writing data and reading it back through the relay

### ✅ `test_relay_realtime_updates`

- **Purpose**: Verify real-time update subscriptions work
- **What it tests**: Multiple updates trigger callbacks correctly

### ✅ `test_relay_nested_data`

- **Purpose**: Verify nested object structures sync correctly
- **What it tests**: Complex nested data can be stored and retrieved

### ✅ `test_relay_chain_operations`

- **Purpose**: Verify chain API works with relay
- **What it tests**: Nested get/put operations like `gun.get('user').get('profile').get('name')`

### ✅ `test_relay_concurrent_connections`

- **Purpose**: Verify multiple Gun instances can sync via relay
- **What it tests**: Data written by one instance is received by another

### ✅ `test_relay_persistence`

- **Purpose**: Verify data persists across connection cycles
- **What it tests**: Data written with one connection is available to a new connection

### ✅ `test_relay_map_operation`

- **Purpose**: Verify property iteration works
- **What it tests**: Can iterate over node properties

### ✅ `test_invalid_relay_url`

- **Purpose**: Verify graceful error handling
- **What it tests**: Invalid relay URLs don't break local operations

### ✅ `test_relay_timeout_handling`

- **Purpose**: Verify operations don't hang indefinitely
- **What it tests**: Network operations complete within timeout

### ✅ `test_relay_connection`

- **Purpose**: Verify basic connectivity to relay
- **What it tests**: Can connect and perform basic operations

## To Run Tests


```bash
# Make sure Rust is installed

rustc --version
cargo --version

# Run all integration tests

cargo test --test integration_tests

# Run with output

cargo test --test integration_tests -- --nocapture

# Run specific test

cargo test --test integration_tests test_relay_put_get
```

## Expected Behavior


These tests should:
1. Connect to your relay server successfully
2. Sync data through the relay
3. Demonstrate real-time updates working
4. Show multi-instance synchronization
5. Verify data persistence

If tests fail, check:
- Network connectivity to relay server
- Relay server is accessible
- WebSocket connections are working
- Data is syncing correctly