useSubscription

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

function SubscriptionDetails({ id }: { id: string }) {
  const { data, isLoading } = useSubscription(id);

  if (isLoading) return <Spinner />;

  return (
    <div>
      <p>Status: {data.status}</p>
      <p>Renews: {new Date(data.current_period_end).toLocaleDateString()}</p>
    </div>
  );
}

const { data } = useSubscriptions({ page: 1, page_size: 10 });

const { mutateAsync: createSubscription } = useCreateSubscription();

await createSubscription({
  customer_id: "cus_123",
  price_id: "price_pro_monthly",
  trial_days: 14,
});

const { mutateAsync: updateSubscription } = useUpdateSubscription(subscriptionId);

await updateSubscription({
  price_id: "price_enterprise_monthly",
  cancel_at_period_end: false,
});

const { mutateAsync: cancel } = useCancelSubscription(subscriptionId);

// Cancel at end of billing period
await cancel({ immediately: false });

// Cancel immediately
await cancel({ immediately: true });

const { mutateAsync: reactivate } = useReactivateSubscription(subscriptionId);

await reactivate();

const { data } = useSubscriptionPreview(subscriptionId, {
  price_id: "price_enterprise_monthly",
});

// data.proration_amount — charge/credit
// data.next_invoice_amount
// data.next_invoice_date

const { data } = useAvailablePlans(subscriptionId);

// data.available_upgrades: AvailablePlan[]
// data.available_downgrades: AvailablePlan[]
// data.current_plan: { product_name, price_id, amount, interval }

const { mutateAsync: preview } = usePreviewPlanChange();

const result = await preview({
  subscriptionId: "sub_123",
  input: { new_price_id: "price_enterprise_monthly" },
});

// result.proration — { amount, credited, charged }
// result.change_type — "upgrade" | "downgrade"
// result.next_billing_date

const { mutateAsync: changePlan } = useChangePlan();

await changePlan({
  subscriptionId: "sub_123",
  input: {
    new_price_id: "price_enterprise_monthly",
    effective_date: "immediate", // or "period_end"
  },
});

interface Subscription {
  id: string
  customer_id: string
  price_id: string
  status: "active" | "canceled" | "incomplete" | "incomplete_expired"
         | "past_due" | "trialing" | "unpaid"
  current_period_start: string
  current_period_end: string
  cancel_at_period_end: boolean
  trial_start?: string
  trial_end?: string
  canceled_at?: string
  metadata?: Record<string, string>
  created_at: string
  updated_at: string
}