accounted/app/api/billing/__tests__/portal.test.ts

/**
 * Tests for POST /api/billing/portal.
 */
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
import { NextResponse } from 'next/server'
import { createQueuedMockSupabase, createMockRequest, parseJsonResponse } from '@/tests/helpers'

const { supabase: serviceSupabase, enqueue, reset } = createQueuedMockSupabase()

const requireAuthMock = vi.fn()
vi.mock('@/lib/auth/require-auth', () => ({
  requireAuth: (...args: unknown[]) => requireAuthMock(...args),
}))

vi.mock('@/lib/company/context', () => ({
  getActiveCompanyId: vi.fn().mockResolvedValue('company-1'),
  requireCompanyId: vi.fn().mockResolvedValue('company-1'),
}))

vi.mock('@/lib/supabase/server', () => ({
  createServiceClient: () => serviceSupabase,
}))

// Keep sandboxBlockedResponse real; stub only the DB-backed guardSandbox.
const guardSandboxMock = vi.fn()
vi.mock('@/lib/sandbox/guard', async (importOriginal) => {
  const actual = await importOriginal<typeof import('@/lib/sandbox/guard')>()
  return { ...actual, guardSandbox: (...args: unknown[]) => guardSandboxMock(...args) }
})

const portalCreate = vi.fn()
vi.mock('@/lib/stripe/client', () => ({
  getStripe: () => ({
    billingPortal: { sessions: { create: portalCreate } },
  }),
}))

import { POST } from '../portal/route'

const routeParams = { params: Promise.resolve({}) }

// The trusted-origin resolver reads the brands table; pin one registered
// brand host so the return-URL tests exercise the real resolver logic.
const resolveBrandResultByHostMock = vi.hoisted(() => vi.fn())
vi.mock('@/lib/branding/resolve', () => ({
  resolveBrandResultByHost: (...args: unknown[]) => resolveBrandResultByHostMock(...args),
}))

const originalAppUrl = process.env.NEXT_PUBLIC_APP_URL

beforeEach(() => {
  vi.clearAllMocks()
  reset()
  process.env.NEXT_PUBLIC_APP_URL = 'https://app.accounted.test'
  resolveBrandResultByHostMock.mockImplementation(async (host: string) => ({
    brand: host === 'portal.brand.test' ? { domain: host } : null,
    lookupFailed: false,
  }))
  guardSandboxMock.mockResolvedValue(null)
  requireAuthMock.mockResolvedValue({ user: { id: 'user-1', is_anonymous: false }, supabase: {}, error: null })
})

afterEach(() => {
  if (originalAppUrl === undefined) delete process.env.NEXT_PUBLIC_APP_URL
  else process.env.NEXT_PUBLIC_APP_URL = originalAppUrl
})

describe('POST /api/billing/portal', () => {
  it('returns 401 when not authenticated', async () => {
    requireAuthMock.mockResolvedValue({
      user: null,
      supabase: {},
      error: NextResponse.json({ error: 'Unauthorized' }, { status: 401 }),
    })

    const req = createMockRequest('/api/billing/portal', { method: 'POST', body: {} })
    const res = await POST(req, routeParams)
    expect(res.status).toBe(401)
  })

  it('blocks an anonymous (demo) user with 403 and never touches Stripe', async () => {
    requireAuthMock.mockResolvedValue({
      user: { id: 'anon-1', is_anonymous: true },
      supabase: {},
      error: null,
    })

    const req = createMockRequest('/api/billing/portal', { method: 'POST', body: {} })
    const { status, body } = await parseJsonResponse<{ sandbox_blocked?: boolean }>(
      await POST(req, routeParams),
    )

    expect(status).toBe(403)
    expect(body.sandbox_blocked).toBe(true)
    expect(portalCreate).not.toHaveBeenCalled()
    expect(guardSandboxMock).not.toHaveBeenCalled()
  })

  it('blocks a sandbox company with 403 and never touches Stripe', async () => {
    const { sandboxBlockedResponse } = await import('@/lib/sandbox/guard')
    guardSandboxMock.mockResolvedValue(sandboxBlockedResponse())

    const req = createMockRequest('/api/billing/portal', { method: 'POST', body: {} })
    const { status, body } = await parseJsonResponse<{ sandbox_blocked?: boolean }>(
      await POST(req, routeParams),
    )

    expect(status).toBe(403)
    expect(body.sandbox_blocked).toBe(true)
    expect(guardSandboxMock).toHaveBeenCalledWith(expect.anything(), 'company-1')
    expect(portalCreate).not.toHaveBeenCalled()
  })

  it('returns 400 with NO_SUBSCRIPTION when the company has no Stripe customer', async () => {
    enqueue({ data: null })

    const req = createMockRequest('/api/billing/portal', { method: 'POST', body: {} })
    const { status, body } = await parseJsonResponse<{ error: { code: string } }>(
      await POST(req, routeParams)
    )

    expect(status).toBe(400)
    expect(body.error.code).toBe('NO_SUBSCRIPTION')
    expect(portalCreate).not.toHaveBeenCalled()
  })

  it('returns the portal URL for a company with a Stripe customer', async () => {
    enqueue({ data: { stripe_customer_id: 'cus_1' } })
    portalCreate.mockResolvedValue({ url: 'https://stripe.test/portal' })

    const req = createMockRequest('/api/billing/portal', { method: 'POST', body: {} })
    const { status, body } = await parseJsonResponse<{ url: string }>(await POST(req, routeParams))

    expect(status).toBe(200)
    expect(body.url).toBe('https://stripe.test/portal')
    expect(portalCreate).toHaveBeenCalledWith(
      expect.objectContaining({ customer: 'cus_1' })
    )
  })

  describe('return URL', () => {
    function portalFrom(url: string) {
      enqueue({ data: { stripe_customer_id: 'cus_1' } })
      portalCreate.mockResolvedValue({ url: 'https://stripe.test/portal' })
      return POST(createMockRequest(url, { method: 'POST' }), routeParams)
    }

    it('comes back to the canonical app when opened there', async () => {
      const { status } = await parseJsonResponse(
        await portalFrom('https://app.accounted.test/api/billing/portal'),
      )

      expect(status).toBe(200)
      expect(portalCreate).toHaveBeenCalledWith({
        customer: 'cus_1',
        return_url: 'https://app.accounted.test/settings/billing',
      })
    })

    it('comes back to a registered white-label host when opened there', async () => {

      const { status } = await parseJsonResponse(
        await portalFrom('https://portal.brand.test/api/billing/portal'),
      )

      expect(status).toBe(200)
      expect(portalCreate).toHaveBeenCalledWith(
        expect.objectContaining({ return_url: 'https://portal.brand.test/settings/billing' }),
      )
    })

    it('falls back to the canonical app for an unregistered or spoofed host', async () => {

      const { status } = await parseJsonResponse(
        await portalFrom('https://portal.brand.test.attacker.test/api/billing/portal'),
      )

      expect(status).toBe(200)
      expect(portalCreate).toHaveBeenCalledWith(
        expect.objectContaining({ return_url: 'https://app.accounted.test/settings/billing' }),
      )
    })
  })
})