Crate surge_sdk 

Surge SDK for Rust

A type-safe Rust interface for the Surge.sh API, enabling programmatic management of static site deployments, domains, SSL certificates, and DNS records.

Key Features

• 🚀 Zero-config publishing to .surge.sh domains
• 🔒 SSL certificate management (requires Pro account)
• 🌐 DNS and domain zone configuration
• 📊 Real-time deployment event streaming
• 🛠️ Async-first design using reqwest and tokio

Quick Start

use surge_sdk::{Config, SurgeSdk, Auth, SURGE_API};
use std::path::Path;

#[tokio::main]
async fn main() -> Result<(), surge_sdk::SurgeError> {
    let config = Config::new(SURGE_API, "0.1.0")?;
    let sdk = SurgeSdk::new(config)?;
    let auth = Auth::Token("your-api-token".into());
     
    sdk.publish(Path::new("./dist"), "your-domain.surge.sh", &auth, None, None).await?;
    Ok(())
}

Re-exports

pub use config::Config;

pub use error::SurgeError;

pub use sdk::SurgeSdk;

pub use stream::calculate_metadata;

pub use stream::publish;

pub use types::Auth;

pub use types::Event;

pub use utils::generate_domain;

pub use utils::json_to_argv;

pub use responses::*;

Modules

config

Configuration module for the Surge SDK.

error

Error handling module for the Surge SDK.

responses

Response Types for Surge API

sdk

Surge SDK for interacting with the Surge API.

stream

Module for streaming project publishing functionality in the Surge SDK.

types

Module defining core data types for the Surge SDK.

utils

Module for utility functions in the Surge SDK.

Constants

SURGE_API

The default Surge.sh API endpoint