Billing, Usage & Add-ons

const { data } = await $fetch('https://taxmtd.uk/api/stripe/subscription')

// Response shape
interface SubscriptionState {
  plan: 'starter' | 'essential' | 'pro' | 'business' | 'practice'
  status: 'active' | 'trialing' | 'past_due' | 'canceled' | 'incomplete' | 'none'
  currentPeriodEnd: string | null
  cancelAtPeriodEnd: boolean
  stripeSubscriptionId?: string
}

const { data } = await $fetch('https://taxmtd.uk/api/usage')

// Response shape
interface UsageCounts {
  entities: number              // Total business entities
  invoices_monthly: number      // Invoices created this calendar month
  ocr_receipts_monthly: number  // Receipts scanned this calendar month
  team_members: number          // Active team members across all entities
  inventory_skus: number        // Total products
  payroll_employees: number     // Total employees
  bank_connections: number      // Total bank connections
}

const { data } = await $fetch('https://taxmtd.uk/api/plan-config')

// Response shape
interface PlanConfig {
  features: PlanFeature[]
  limits: PlanLimit[]
}

interface PlanFeature {
  feature_slug: string
  min_plan: 'starter' | 'essential' | 'pro' | 'business' | 'practice'
  category: string
  label: string
  description: string | null
  sort_order: number
}

interface PlanLimit {
  plan: 'starter' | 'essential' | 'pro' | 'business' | 'practice'
  limit_key: string
  limit_value: number   // -1 = unlimited
}

const { data } = await $fetch('https://taxmtd.uk/api/addons')

// Response shape
interface AddonsResponse {
  catalog: AddonDefinition[]
  purchased: PurchasedAddon[]
}

interface AddonDefinition {
  slug: string
  label: string
  description: string
  unit_label: string
  grant_per_unit: number
  limit_key: string
  price_monthly_pence: number
  price_annual_pence: number
}

interface PurchasedAddon {
  id: string
  addon_slug: string
  quantity: number
  status: 'active' | 'canceled'
  date_created?: string
}

const { data } = await $fetch('https://taxmtd.uk/api/addons', {
  method: 'POST',
  body: { addon_slug: 'extra_entities', quantity: 1 }
})
// With active subscription: { success: true, method: 'subscription_item' }
// Without subscription:     { url: 'https://checkout.stripe.com/...' }

const { data } = await $fetch('https://taxmtd.uk/api/stripe/checkout', {
  method: 'POST',
  body: {
    priceId: 'price_...',
    plan: 'pro',
    interval: 'annual'
  }
})
// Redirect user to: data.url

const { data } = await $fetch('https://taxmtd.uk/api/stripe/portal', {
  method: 'POST'
})
// Redirect user to: data.url