posemesh-domain-http 1.4.2

HTTP client library for interacting with AukiLabs domain data services, supporting both native and WebAssembly targets.
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

# posemesh-domain-http

Cross-platform HTTP client for Auki posemesh domains (native + WASM) with Rust, JavaScript, and Python bindings.

## Authentication Modes
- **App credentials (key/secret)**: read-all, no writes.
- **User credentials (email/password)**: read-all + write own org domains.
- **OIDC access token**: read/write per assigned roles.

## Key Features
- Streaming downloads and uploads (WASM streaming download; uploads not in Python).
- Domain listing/creation/deletion helpers.
- Reconstruction job submission.
- JavaScript package [`@auki/domain-client`](https://www.npmjs.com/package/@auki/domain-client) for browsers, Deno, and Node 18+ (ReadableStream).

## Usage
`client_id` must be non-empty (use device/user ID on frontend; unique service ID on backend).

### Rust
```rust
use posemesh_domain_http::{DomainClient, DownloadQuery, ListDomainsQuery};

let client = DomainClient::new_with_user_credential(
    &api_url, &dds_url, &client_id, &email, &password, true)?;
let domains = client.list_domains(&ListDomainsQuery{ org: "own".into(), portal_id: None, portal_short_id: None }).await?;
let data = client.download_domain_data(&domain_id, &DownloadQuery{ ids: vec![], name: None, data_type: None }).await?;
```

### JavaScript / TypeScript
```ts
import { DomainClient } from "@auki/domain-client";
const client = await DomainClient.new_with_user_credential(apiUrl, ddsUrl, clientId, email, password, true);
const domains = await client.listDomains({ org: "own" });
const data = await client.downloadDomainData(domainId, { ids: [] });
client.free();
```

### Python
```python
from auki_domain_client import DomainClient, ListDomainsQuery, DownloadQuery
client = DomainClient.new_with_user_credential(api_url, dds_url, client_id, email, password, True)
domains = client.list_domains(ListDomainsQuery(org="own", portal_id=None, portal_short_id=None))
data = client.download_domain_data(domain_id, DownloadQuery(ids=[], name=None, data_type=None))
```

## Build
- Native: `cargo build -p posemesh-domain-http --release`
- WASM JS pkg: `make build-domain-http TARGET=wasm` → `domain-http/bindings/javascript/pkg`
- Python pkg: `make build-domain-http TARGET=python` → `domain-http/bindings/python/.venv/lib/auki_domain_client`

## Test
`make unit-tests` (runs Rust + JS/WASM)

## Changelog
See [CHANGELOG.md](https://github.com/aukilabs/posemesh/blob/main/core/domain-http/CHANGELOG.md).