grabcli-service 0.2.0

A service-shaped Grab client over grabcli: plain types, client/backend traits, a phone-login state machine, text rendering and a fake backend
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

# grabcli-service

[![crates.io](https://img.shields.io/crates/v/grabcli-service.svg)](https://crates.io/crates/grabcli-service)
[![docs.rs](https://docs.rs/grabcli-service/badge.svg)](https://docs.rs/grabcli-service)

A service-shaped Grab (food delivery) client over
[grabcli](https://github.com/talaagent/grabcli/blob/master/README.md)'s library crates, for a server or a bot that keeps
many people's Grab accounts in its own storage.

The `grab` binary keeps one account in files; this crate keeps none. It
gives an embedder:

- `api`: plain, serde-able types (`Merchant`, `Menu`, `Cart`, `Quote`,
  `Placed`, `Tracked`), the per-account `GrabClient` (search, menu, cart,
  quote, place order, track, refresh), the `LoginDriver`, the `GrabBackend`
  that makes both, and `money` (`₱1,234.50`).
- `SessionSlot`: the seam to your storage. A session is opaque JSON
  (grabcli's `Session`), read and saved only through the slot; the client's
  silent refreshes save there too. `MemorySlot` is an in-memory one.
- `real`: the backend over `grabcli-core` and `grabfood`.
- `fake`: a backend with no network and made-up merchants, for tests and
  local development (a phone ending in `1` is approved in the app, one
  ending in `9` fails a step-up, any other gets the code `123456`).
- `login`: many phone logins at once (`Logins`), each on its own thread,
  bound to the person who started it, one at a time per account, with a
  per-account code-send budget (60 s apart, 3 an hour by default).
  A connected account's `display_name` is grabcli's masked phone
  (`+1••••••••00`): it shows the number's last two digits, so treat it as
  personal data where you display or log it.
- `text`: the answers as plain text, for a chat reply or a model.

Nothing is printed or read from disk or the environment; diagnostics go to an
optional `Log` hook, and phones and codes stay in `Secret`s that never print.
A login's failure message has its phone redacted, and the `Debug` of
`Step`, `LoggedIn` and `MemorySlot` never shows a session.

## Example

```rust,no_run
use std::sync::Arc;
use grabcli_service::{CartOp, GrabBackend, MemorySlot, fake::Fake, text};

# async fn run() -> grabcli_service::GrabResult<()> {
let client = Fake::default().client(Arc::new(MemorySlot::new(
    "acct-1",
    Some(Fake::session("Sample")),
)));
let menu = client.menu("fake-ramen").await?;
client
    .cart(&CartOp::Add {
        merchant_id: menu.merchant.id.clone(),
        item_id: menu.items[0].id.clone(),
        quantity: 1,
        note: None,
    })
    .await?;
println!("{}", text::quote(&client.quote().await?));
# Ok(())
# }
```

See [`examples/fake_order.rs`](https://github.com/talaagent/grabcli/blob/master/crates/grabcli-service/examples/fake_order.rs)
(`cargo run -p grabcli-service --example fake_order`).

## Safety

The real backend keeps grabcli's gates: orders go through only with
`allow_ordering = true` in the `grabcli_core::Config` passed to `Real::new`,
and only against a quote id that matches a fresh re-quote. Never retry
`place_order` (Grab's submit has no idempotency key); check `track` instead.
The quote and order path never reads the browse cache.

See the root README's [disclaimer](https://github.com/talaagent/grabcli/blob/master/README.md#disclaimer).

## License

[Apache-2.0](https://github.com/talaagent/grabcli/blob/master/LICENSE.txt)