domainstack-wasm 1.0.0

WASM browser validation for domainstack: run the same validation logic in browser and server
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

# domainstack-wasm

[![Blackwell Systems™](https://raw.githubusercontent.com/blackwell-systems/blackwell-docs-theme/main/badge-trademark.svg)](https://github.com/blackwell-systems)
[![Crates.io](https://img.shields.io/crates/v/domainstack-wasm.svg)](https://crates.io/crates/domainstack-wasm)
[![Documentation](https://docs.rs/domainstack-wasm/badge.svg)](https://docs.rs/domainstack-wasm)
[![npm](https://img.shields.io/npm/v/@domainstack/wasm.svg)](https://www.npmjs.com/package/@domainstack/wasm)

WASM browser validation for domainstack. Run the same validation logic in both browser and server.

## Quick Start

```bash
# Build WASM package
wasm-pack build --target web --release
```

```javascript
import init, { createValidator, validate } from '@domainstack/wasm';

// Initialize WASM module
await init();

// Create validator instance
const validator = createValidator();

// Validate data
const result = validator.validate('Booking', JSON.stringify({
  guest_email: 'invalid',
  rooms: 15
}));

if (!result.ok) {
  result.errors?.forEach(e => {
    console.log(`${e.path}: ${e.message}`);
  });
}
```

## Why WASM?

- **Zero drift** — Same Rust validation code runs in browser and server
- **Type safety** — Validation errors match server response format exactly
- **Small bundle** — ~60KB uncompressed, smaller gzipped

## Registering Types

Types must be registered before validation:

```rust
use domainstack::prelude::*;
use domainstack_wasm::register_type;
use serde::Deserialize;

#[derive(Debug, Validate, Deserialize)]
struct Booking {
    #[validate(email)]
    guest_email: String,

    #[validate(range(min = 1, max = 10))]
    rooms: u8,
}

// Register at app initialization
register_type::<Booking>("Booking");
```

## API

### Rust

| Function | Description |
|----------|-------------|
| `register_type::<T>(name)` | Register a type for validation |
| `validate(type_name, json)` | Validate JSON string |
| `validate_object(type_name, value)` | Validate JS object |
| `createValidator()` | Create validator instance |

### JavaScript/TypeScript

```typescript
interface ValidationResult {
  ok: boolean;
  errors?: Violation[];      // Validation failures
  error?: SystemError;       // System error (unknown type, parse failure)
}

interface Violation {
  path: string;
  code: string;
  message: string;
  meta?: Record<string, string>;
}

interface SystemError {
  code: 'unknown_type' | 'parse_error';
  message: string;
}
```

## Building

```bash
# Install WASM target
rustup target add wasm32-unknown-unknown

# Build with wasm-pack
wasm-pack build --target web --release

# Output in pkg/
ls pkg/
```

## Documentation

- [Implementation Guide](../domainstack/docs/WASM_VALIDATION.md) — Architecture, API design, phases
- [Publishing Guide](../domainstack/docs/PUBLISHING.md) — Dual crates.io + npm workflow

## License

MIT OR Apache-2.0