agentlink-wasm 0.1.0

AgentLink SDK WASM - WebAssembly bindings for browser/Node.js
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

# AgentLink SDK WASM

WebAssembly bindings for AgentLink SDK, enabling usage in browsers and Node.js.

## Building

```bash
# Build the WASM target
cargo build -p agentlink-wasm --target wasm32-unknown-unknown --release

# Generate JavaScript/TypeScript bindings
wasm-bindgen target/wasm32-unknown-unknown/release/agentlink_wasm.wasm \
  --out-dir pkg \
  --target web \
  --typescript
```

## Usage

### In a Web Application

```html
<!DOCTYPE html>
<html>
<head>
    <script type="module">
        import init, { JsHttpClient, JsMqttClient, getVersion, init as sdkInit } from './pkg/agentlink_wasm.js';
        
        async function main() {
            // Initialize the WASM module
            await init();
            
            // Initialize SDK logging
            sdkInit();
            
            console.log('SDK Version:', getVersion());
            
            // Create HTTP client
            const httpClient = new JsHttpClient('https://api.example.com');
            
            // Set auth token
            httpClient.setAuthToken('your-auth-token');
            
            // Make requests
            try {
                const response = await httpClient.get('/users/me');
                console.log('User:', response);
            } catch (e) {
                console.error('Error:', e);
            }
            
            // Create MQTT client
            const mqttClient = new JsMqttClient();
            
            // Set up event handler
            mqttClient.onEvent((event) => {
                console.log('MQTT Event:', event);
            });
            
            // Connect to broker
            await mqttClient.connect('wss://mqtt.example.com/mqtt', 'client-1', 'username');
            
            // Subscribe to topic
            await mqttClient.subscribe('chat/room/1', 1);
            
            // Publish message
            const payload = new TextEncoder().encode('Hello, World!');
            await mqttClient.publish('chat/room/1', payload, 1);
        }
        
        main();
    </script>
</head>
<body>
    <h1>AgentLink SDK WASM Demo</h1>
</body>
</html>
```

### In Node.js

Use `--target bundler` or `--target nodejs` when running `wasm-bindgen`:

```bash
wasm-bindgen target/wasm32-unknown-unknown/release/agentlink_wasm.wasm \
  --out-dir pkg-node \
  --target nodejs
```

```javascript
const { JsHttpClient, JsMqttClient, getVersion } = require('./pkg-node/agentlink_wasm.js');

console.log('SDK Version:', getVersion());

const client = new JsHttpClient('https://api.example.com');
// ... use the client
```

## API

### JsHttpClient

- `new JsHttpClient(baseUrl: string)` - Create a new HTTP client
- `setAuthToken(token: string)` - Set authentication token
- `getAuthToken(): string | undefined` - Get current auth token
- `get(path: string): Promise<any>` - Perform GET request
- `post(path: string, body: any): Promise<any>` - Perform POST request
- `put(path: string, body: any): Promise<any>` - Perform PUT request
- `delete(path: string): Promise<any>` - Perform DELETE request

### JsMqttClient

- `new JsMqttClient()` - Create a new MQTT client
- `connect(brokerUrl: string, clientId: string, username?: string): Promise<void>` - Connect to broker
- `disconnect(): Promise<void>` - Disconnect from broker
- `subscribe(topic: string, qos: number): Promise<void>` - Subscribe to topic
- `unsubscribe(topic: string): Promise<void>` - Unsubscribe from topic
- `publish(topic: string, payload: Uint8Array, qos: number): Promise<void>` - Publish message
- `getConnectionState(): string` - Get connection state
- `onEvent(callback: Function)` - Set event callback

### Functions

- `init()` - Initialize the SDK (sets up panic hook and logger)
- `getVersion(): string` - Get SDK version
- `loginWithEmailCode(baseUrl: string, email: string, code: string): Promise<any>` - Login helper

## Features

- ✅ HTTP Client using Fetch API
- ✅ MQTT Client using WebSocket
- ✅ TypeScript definitions included
- ✅ Async/Promise-based API
- ✅ Event callbacks for MQTT

## Notes

- The MQTT client uses WebSocket connections (ws:// or wss://)
- MQTT URLs are automatically converted: `mqtt://` → `ws://`, `mqtts://` → `wss://`
- The SDK requires a modern browser with WebAssembly support