bachs-sdk 0.1.0

Unofficial Rust SDK for the Bachs API — payments and billing for internet businesses.
Documentation
use bachs_sdk::subscriptions::{CancelSubscriptionRequest, CancellationTiming, Subscription};
use bachs_sdk::Bachs;
use wiremock::matchers::{header, method, path};
use wiremock::{Mock, MockServer, ResponseTemplate};

#[tokio::test]
async fn retrieves_a_subscription() {
    let server = MockServer::start().await;

    let body = serde_json::json!({
        "subscription_id": "sub_1a2b3c4d5e6f",
        "customer_id": "cust_123",
        "status": "active",
        "created_at": "2026-07-13T14:00:00.000Z",
        "updated_at": "2026-07-13T14:00:00.000Z"
    });

    Mock::given(method("GET"))
        .and(path("/v1/subscriptions/sub_abc123"))
        .respond_with(ResponseTemplate::new(200).set_body_json(body))
        .mount(&server)
        .await;

    let bachs = Bachs::builder("sk_sandbox_test123")
        .base_url(server.uri())
        .build()
        .unwrap();

    let sub = bachs.subscriptions().get("sub_abc123").await.unwrap();
    assert_eq!(sub.subscription_id, "sub_1a2b3c4d5e6f");
    assert_eq!(sub.customer_id.as_deref(), Some("cust_123"));
}

#[tokio::test]
async fn updates_a_subscription() {
    let server = MockServer::start().await;

    let body = serde_json::json!({
        "subscription_id": "sub_abc123",
        "customer_id": "cust_123",
        "status": "active",
        "metadata": {"tier": "gold"},
        "created_at": "2026-07-13T14:00:00.000Z",
        "updated_at": "2026-07-14T10:00:00.000Z"
    });

    Mock::given(method("PATCH"))
        .and(path("/v1/subscriptions/sub_abc123"))
        .respond_with(ResponseTemplate::new(200).set_body_json(body))
        .mount(&server)
        .await;

    let bachs = Bachs::builder("sk_sandbox_test123")
        .base_url(server.uri())
        .build()
        .unwrap();

    let metadata = {
        let mut m = std::collections::HashMap::new();
        m.insert("tier".into(), serde_json::Value::String("gold".into()));
        m
    };

    let sub = bachs
        .subscriptions()
        .update("sub_abc123", &bachs_sdk::subscriptions::UpdateSubscriptionRequest::new().metadata(metadata))
        .await
        .unwrap();

    assert_eq!(sub.metadata.get("tier"), Some(&serde_json::Value::String("gold".into())));
}

#[tokio::test]
async fn cancels_a_subscription_immediately() {
    let server = MockServer::start().await;

    let body = serde_json::json!({
        "subscription_id": "sub_abc123",
        "status": "canceled",
        "created_at": "2026-07-13T14:00:00.000Z"
    });

    Mock::given(method("POST"))
        .and(path("/v1/subscriptions/sub_abc123/cancel"))
        .respond_with(ResponseTemplate::new(200).set_body_json(body))
        .mount(&server)
        .await;

    let bachs = Bachs::builder("sk_sandbox_test123")
        .base_url(server.uri())
        .build()
        .unwrap();

    let sub = bachs
        .subscriptions()
        .cancel("sub_abc123", &CancelSubscriptionRequest { timing: CancellationTiming::Immediately })
        .await
        .unwrap();

    assert_eq!(sub.status.as_deref(), Some("canceled"));
}

#[tokio::test]
async fn cancels_a_subscription_at_period_end() {
    let server = MockServer::start().await;

    let body = serde_json::json!({
        "subscription_id": "sub_abc123",
        "status": "active",
        "created_at": "2026-07-13T14:00:00.000Z"
    });

    Mock::given(method("POST"))
        .and(path("/v1/subscriptions/sub_abc123/cancel"))
        .respond_with(ResponseTemplate::new(200).set_body_json(body))
        .mount(&server)
        .await;

    let bachs = Bachs::builder("sk_sandbox_test123")
        .base_url(server.uri())
        .build()
        .unwrap();

    bachs
        .subscriptions()
        .cancel("sub_abc123", &CancelSubscriptionRequest::default())
        .await
        .unwrap();
}

#[tokio::test]
async fn lists_subscriptions() {
    let server = MockServer::start().await;

    let body = serde_json::json!({
        "items": [
            {"subscription_id": "sub_1", "status": "active", "created_at": "2026-07-13T14:00:00.000Z"},
            {"subscription_id": "sub_2", "status": "past_due", "created_at": "2026-07-13T14:00:00.000Z"}
        ],
        "pagination": {"has_more": true, "next_cursor": "cursor_1"}
    });

    Mock::given(method("GET"))
        .and(path("/v1/subscriptions"))
        .respond_with(ResponseTemplate::new(200).set_body_json(body))
        .mount(&server)
        .await;

    let bachs = Bachs::builder("sk_sandbox_test123")
        .base_url(server.uri())
        .build()
        .unwrap();

    let result = bachs.subscriptions().list(&bachs_sdk::ListParams::new()).await.unwrap();
    assert_eq!(result.items.len(), 2);
    assert!(result.pagination.has_more);
    assert_eq!(result.pagination.next_cursor.as_deref(), Some("cursor_1"));
}