#ryota0624/googleapis

#Features

• HttpClient trait with pluggable implementation (default: mizchi/x/http)
• GoogleClient - async token provider, auto-injected auth headers, error parsing
• Protobuf-based code generator - generate typed MoonBit clients from buf Image JSON
  • Path / query / body parameters
  • Repeated (array) query parameters
  • POST request body serialization
  • Server-streaming responses
• 10 generated Google API clients - Cloud Storage, Firestore, BigQuery Storage, Pub/Sub, Logging, Cloud Tasks, Cloud Scheduler, Cloud Trace, Monitoring, Error Reporting

#Installation

{
  "deps": {
    "ryota0624/googleapis": "0.3.0"
  }
}

#Quick Start

#Firestore - List documents

///|
async fn main {
  let token = @sys.get_env_var("GOOGLE_ACCESS_TOKEN").unwrap()
  let project = @sys.get_env_var("GCP_PROJECT").unwrap()
  let client = @core.GoogleClient::new(fn() { token })
  let firestore = @gfs.FirestoreService::new(client)
  let parent = "projects/" + project + "/databases/(default)/documents"
  let result = firestore.list_documents(
    parent,
    "my-collection",
    page_size=Some(10),
  )
  match result.documents {
    Some(docs) =>
      for doc in docs {
        println(doc.name.unwrap_or("(unnamed)"))
      }
    None => println("(no documents)")
  }
}

#Cloud Storage - List objects

///|
async fn main {
  let token = @sys.get_env_var("GOOGLE_ACCESS_TOKEN").unwrap()
  let project = @sys.get_env_var("GCP_PROJECT").unwrap()
  let client = @core.GoogleClient::new(fn() { token })
  let storage = @gcs.StorageService::new(client)
  let result = storage.objects_list("my-bucket")
  match result.items {
    Some(items) =>
      for obj in items {
        println(obj.name.unwrap_or("(unnamed)"))
      }
    None => println("(no objects)")
  }
}

#Run samples

export GOOGLE_ACCESS_TOKEN="$(gcloud auth print-access-token)"
export GCP_PROJECT="your-project-id"

# Firestore
export FIRESTORE_COLLECTION="your-collection"
moon run sample/firestore --target native

# Cloud Storage
moon run sample/storage --target native

#Code Generator

# Build the buf Image (one-time, cached in /tmp)
cd googleapis && buf build . --exclude-path preview --output json -o /tmp/googleapis-image.json

# Generate a client for a specific API
moon run codegen --target native -- google.firestore.v1 --output generated/firestore
moon run codegen --target native -- google.pubsub.v1 --output generated/pubsub

# Regenerate all bundled clients
# (mirrors the logic in .github/workflows/generate.yml)

#Generated Services

#Package Structure

#Authentication

• ryota0624/googleauth (MoonBit OAuth2 library)
• gcloud auth print-access-token
• Any OAuth2 flow

///|
let client = @core.GoogleClient::new(fn() { get_fresh_token() })

#Dependencies

• mizchi/x - HTTP client (native + js)
• moonbitlang/async - Async runtime

#License