goldenpay 0.3.0

Production-oriented Rust SDK for FunPay automation
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

# goldenpay

Production-oriented Rust library for FunPay automation.

## Included

- session-based client
- proxy support
- retry policy
- order polling bot
- state storage
- delivery automation helpers
- chat messaging
- order page parsing
- offer read and edit
- price calculation
- category and offer listing

## Quick start

```rust
use goldenpay::{GoldenPay, GoldenPayBot, GoldenPayConfig, GoldenPayEvent, RetryPolicy};
use std::time::Duration;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = GoldenPay::new(GoldenPayConfig::builder()
        .golden_key("golden_key_here")
        .state_path("data/state.json")
        .poll_interval(Duration::from_secs(2))
        .retry_policy(RetryPolicy::new(4, Duration::from_millis(250)))
        .build())?;

    let session = client.connect().await?;
    let mut bot = GoldenPayBot::new(session);

    bot.load_state().await?;
    bot.bootstrap().await?;

    bot.run(|event, session| async move {
        match event {
            GoldenPayEvent::NewOrder(order) => {
                session
                    .send_message(&order.chat_id, "Thanks for your order")
                    .await?;
            }
            GoldenPayEvent::NewMessage(message) => {
                println!("{:?}", message.text);
            }
        }

        Ok(())
    })
    .await?;

    Ok(())
}
```

## Main API

- `GoldenPay::connect()`
- `GoldenPaySession::send_message()`
- `GoldenPaySession::fetch_orders()`
- `GoldenPaySession::fetch_paid_orders()`
- `GoldenPaySession::fetch_order_page()`
- `GoldenPaySession::fetch_offer_details()`
- `GoldenPaySession::edit_offer()`
- `GoldenPaySession::calc_price()`
- `GoldenPaySession::fetch_category_metadata()`
- `DeliveryService::process_paid_order()`
- `DeliveryService::remaining_items()`
- `GoldenPayBot::load_state()`
- `GoldenPayBot::bootstrap()`
- `GoldenPayBot::poll_once()`

## Automation example

See [examples/process_paid_order.rs](/D:/Funpay/goldenpay/examples/process_paid_order.rs) for a
high-level flow that:

- finds a paid order
- reserves delivery items
- deduplicates processed orders through `JsonDeliveryStore`
- builds a delivery message
- sends the message to the buyer chat