BillingOSClient

import { useBillingOS } from "@billingos/sdk";

function MyComponent() {
  const { client } = useBillingOS();

  // client is null until the session token loads
  if (!client) return null;

  const subscription = await client.getSubscription("sub_123");
}

import { BillingOSClient } from "@billingos/sdk";

const client = new BillingOSClient("bos_session_test_xxx", {
  baseUrl: "https://api.billingos.dev",
});

interface BillingOSClientOptions {
  baseUrl?: string                     // API base URL (auto-detected from token)
  environment?: "production" | "sandbox"
  version?: string                     // API version
  headers?: Record<string, string>     // Custom headers
  timeout?: number                     // Request timeout (ms)
}

import {
  BillingOSError,
  UnauthorizedError,
  NotFoundError,
  ValidationError,
  RateLimitError,
  ServerError,
  NetworkError,
} from "@billingos/sdk";

try {
  await client.getSubscription("sub_invalid");
} catch (error) {
  if (error instanceof NotFoundError) {
    console.log("Subscription not found");
  } else if (error instanceof UnauthorizedError) {
    console.log("Session token expired");
  }
}

// Via the global window object
window.billingOS?.checkout.open({
  priceId: "price_pro_monthly",
  onSuccess: (subscription) => console.log("Subscribed!", subscription),
  onError: (error) => console.error("Failed:", error),
  onCancel: () => console.log("Cancelled"),
});

// Or using the exported function
import { openCheckout } from "@billingos/sdk";

const result = await openCheckout({
  priceId: "price_pro_monthly",
  sessionToken: "bos_session_test_...",
});