cratefield-module-waitlist 0.3.0

Cratefield module: per-product waitlist with confirm, position, referral codes
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

<p align="center">
  <a href="https://github.com/Cratefield/harness">
    <img src="https://raw.githubusercontent.com/Cratefield/harness/main/assets/banners/cratefield-module-waitlist.png" alt="cratefield-module-waitlist — A place in the queue." width="100%">
  </a>
</p>

<p align="center">
  <a href="https://crates.io/crates/cratefield-module-waitlist"><img src="https://img.shields.io/crates/v/cratefield-module-waitlist.svg?style=flat-square&labelColor=0A0A0B&color=4C6FFF" alt="cratefield-module-waitlist on crates.io"></a>
  <a href="https://docs.rs/cratefield-module-waitlist"><img src="https://img.shields.io/docsrs/cratefield-module-waitlist?style=flat-square&labelColor=0A0A0B&color=EDEBE6" alt="cratefield-module-waitlist documentation"></a>
  <a href="https://github.com/Cratefield/harness/blob/main/LICENSE"><img src="https://img.shields.io/badge/LICENSE-MIT-4C6FFF?style=flat-square&labelColor=0A0A0B" alt="MIT"></a>
</p>

# cratefield-module-waitlist

Per-product waitlist for a Cratefield venture: `POST /v1/waitlist`
joins, a signed confirmation link assigns a dense per-product position,
referral codes credit the referrer, and a status endpoint shows the
entry's place and share link.

```rust
use cratefield_module_waitlist::Waitlist;

let module = Waitlist::new()
    .products(["kontinuum", "undercover-rockstars"])
    .confirm_ttl_days(7)
    .referrals(true);
```

Joins may carry a free-form `answers` JSON object: `.answers_schema(|answers| ..)`
validates it whenever answers are present, `.require_answers(true)` rejects
joins without them, and the admin export carries the stored answers as a
quoted CSV column.

**Position semantics**: positions are per product, assigned densely at
confirm time from a per-product counter on `waitlist_position_lock` that
the lock-taking UPDATE increments, inside one all-or-nothing
`Database::batch_atomic`, so concurrent confirms of the same product
serialize on every engine (D1, SQLite, Postgres) and never share a
position; a UNIQUE(product, position) index backstops the allocation.
Positions are never recomputed when rows are deleted.

Register the default mail templates in the venture's `src/lib.rs`:

```rust
use cratefield_core::Harness;
use cratefield_module_waitlist::default_templates;

let builder = Harness::builder().templates(default_templates());
```

Emits `waitlist.joined` and `waitlist.confirmed`; pair with
`cratefield-module-email-signup`'s
`.subscribe_on_waitlist_confirm(true)` to mirror confirmed addresses
into the signup list — no crate dependency between the modules.

See `docs/ARCHITECTURE.md` section 6 (Waitlist) and section 11.

---

MIT. Built in the open for [Cratefield](https://cratefield.com), a [Factory Zero](https://factory0.ventures) venture.