rerout 0.6.0

Official Rust SDK for the Rerout branded-link API.
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

# Changelog

All notable changes to the `rerout` crate are documented in this file. The
format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.6.0] - 2026-07-13

### Added

- Explicit isolated sandbox selection, automatic routing to
  \`https://sandbox-api.rerout.co\`, and fail-closed validation that prevents
  genuine \`rrk_test_\` credentials from being mixed with live keys.

## [0.5.0] - 2026-06-20

### Added

- New `tags` namespace via `Rerout::tags()` — `list`, `create`, `update`, and
  `delete` against `/v1/projects/me/tags` (API-key auth, project resolved from
  the key). `list` returns `ListTagsResult { tags: Vec<TagSummary> }`, where
  `TagSummary` flattens a `Tag` plus its live `link_count`; `create` / `update`
  return a plain `Tag`; `delete` returns `DeleteTagResult { deleted }`. New
  `TagSummary`, `ListTagsResult`, `CreateTagInput` (`new` + `with_color`),
  `UpdateTagInput` (`new` + `with_name` / `with_color`), and `DeleteTagResult`
  types, all re-exported from the crate root.

## [0.4.0] - 2026-06-04

### Added

- Smart Links fields on `Link`: `password_protected`, `max_clicks`,
  `click_count`, `track_conversions`, `routing_rules` (`Vec<RoutingRule>` with
  `{ condition_type, condition_op, condition_value, target_url }`), and
  `ab_variants` (`Vec<AbVariant>` with `{ id, target_url, weight }`).
- Smart Links inputs on `CreateLinkInput` (`with_password`, `with_max_clicks`,
  `with_track_conversions`, `with_routing_rules`, `with_ab_variants`) and on
  `UpdateLinkInput` (`set_password`/`clear_password`,
  `set_max_clicks`/`clear_max_clicks`, `set_track_conversions`, and the
  full-replace `set_routing_rules` / `set_ab_variants`). New `RoutingRule`,
  `AbVariant`, and `CreateAbVariantInput` types.
- New `conversions` namespace via `Rerout::conversions()` — `record` against
  `POST /v1/conversions`, returning `ConversionResult { recorded, duplicate }`.
  New `RecordConversionInput` / `ConversionResult` types.
- Batch link creation via `Links::create_batch` — `POST /v1/links/batch`,
  returning `BatchCreateLinksResult { created, total, results }`. New
  `BatchLinkInput`, `BatchLinkResult`, and `BatchCreateLinksResult` types.
- New webhook event type `conversion.recorded` is now deliverable.

## [0.3.0] - 2026-06-03

### Added

- Webhook endpoint management via `Rerout::webhooks()` — `create`, `list`, and
  `delete` against `/v1/projects/me/webhooks` (API-key auth). The signing secret
  returned by `create` is shown once.

## [0.2.0] - 2026-06-02

### Added

- Read-only `tags` field on `Link` — a `Vec<Tag>` where each `Tag` carries
  `{ id, name, color }`. Returned by `get`, `list`, and `update`; empty on
  `create`. Tag writes are ignored for API-key clients.
- `Tag` is re-exported from the crate root.

### Notes

- The project stats endpoint `/v1/projects/me/stats` (used by
  `project().stats`) is now live.

## [0.1.0] - 2026-05-22

### Added

- Initial public release.
- `Rerout` async client with `links()`, `project()`, and `qr()` namespaces,
  constructed through `Rerout::builder` (configurable `base_url`, `timeout`,
  `user_agent`, and an injectable `reqwest::Client`).
- Link operations: `create`, `list`, `get`, `update`, `delete`, `stats`.
- Project operations: `stats`, `me`.
- QR helpers: pure URL builder (`qr().url`) and authenticated SVG fetch
  (`qr().svg`), plus the standalone `build_qr_url` function.
- `CreateLinkInput` and `UpdateLinkInput` builders; `UpdateLinkInput` uses the
  `Option<Option<T>>` pattern with `set_*` / `clear_*` methods to distinguish
  "leave the field alone" from "clear it on the server", and rejects an empty
  payload client-side.
- `webhooks::verify_rerout_signature` — HMAC-SHA256 webhook signature
  verification with configurable timestamp tolerance and a constant-time
  comparison via `subtle`.
- `ReroutError` enum with stable `code`, `status`, and `message` accessors;
  optional `path`, `timestamp`, and `details` from the API error envelope; and
  `is_rate_limited` / `is_server_error` convenience flags.
- `rustls`-backed TLS with no OpenSSL dependency.
- `#![forbid(unsafe_code)]` across the crate.

[0.4.0]: https://github.com/ModestNerds-Co/rerout-sdks/releases/tag/rust/v0.4.0
[0.3.0]: https://github.com/ModestNerds-Co/rerout-sdks/releases/tag/rust/v0.3.0
[0.2.0]: https://github.com/ModestNerds-Co/rerout-sdks/releases/tag/rust-v0.2.0
[0.1.0]: https://github.com/ModestNerds-Co/rerout-sdks/releases/tag/rust-v0.1.0