chore: import upstream snapshot with attribution

apps/sim/lib/billing/webhooks/outbox-handlers.test.ts

@@ -0,0 +1,184 @@
+/**
+ * @vitest-environment node
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+const { mockGetPlanByName, mockResolveDefaultPaymentMethod, queryQueue, stripeMock } = vi.hoisted(
+  () => {
+    const stripeMock = {
+      subscriptions: {
+        retrieve: vi.fn(),
+        update: vi.fn(),
+      },
+    }
+    return {
+      mockGetPlanByName: vi.fn(),
+      mockResolveDefaultPaymentMethod: vi.fn(),
+      queryQueue: { value: [] as unknown[][] },
+      stripeMock,
+    }
+  }
+)
+
+vi.mock('@sim/db', () => {
+  const makeChain = () => {
+    const chain: Record<string, unknown> = {}
+    chain.from = () => chain
+    chain.where = () => chain
+    chain.limit = () => Promise.resolve(queryQueue.value.shift() ?? [])
+    return chain
+  }
+  return { db: { select: () => makeChain() } }
+})
+
+vi.mock('@/lib/billing/stripe-client', () => ({
+  requireStripeClient: () => stripeMock,
+}))
+
+vi.mock('@/lib/billing/plans', () => ({
+  getPlanByName: mockGetPlanByName,
+}))
+
+vi.mock('@/lib/billing/stripe-payment-method', () => ({
+  resolveDefaultPaymentMethod: mockResolveDefaultPaymentMethod,
+}))
+
+import { billingOutboxHandlers, OUTBOX_EVENT_TYPES } from '@/lib/billing/webhooks/outbox-handlers'
+
+const seatSyncHandler = billingOutboxHandlers[OUTBOX_EVENT_TYPES.STRIPE_SYNC_SUBSCRIPTION_SEATS]
+
+const ctx = {
+  eventId: 'evt-1',
+  eventType: OUTBOX_EVENT_TYPES.STRIPE_SYNC_SUBSCRIPTION_SEATS,
+  attempts: 0,
+}
+
+function stripeItem(overrides: {
+  quantity?: number
+  priceId?: string
+  interval?: 'month' | 'year'
+}) {
+  return {
+    status: 'active',
+    items: {
+      data: [
+        {
+          id: 'si_1',
+          quantity: overrides.quantity ?? 1,
+          price: {
+            id: overrides.priceId ?? 'price_pro_month',
+            recurring: { interval: overrides.interval ?? 'month' },
+          },
+        },
+      ],
+    },
+  }
+}
+
+describe('stripeSyncSubscriptionSeats outbox handler', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+    queryQueue.value = []
+    mockGetPlanByName.mockReturnValue({
+      priceId: 'price_team_month',
+      annualDiscountPriceId: 'price_team_year',
+    })
+    stripeMock.subscriptions.update.mockResolvedValue({})
+  })
+
+  it('reconciles both price and quantity for a Pro→Team conversion', async () => {
+    const row = {
+      plan: 'team_6000',
+      seats: 2,
+      status: 'active',
+      stripeSubscriptionId: 'stripe_sub',
+    }
+    queryQueue.value = [[row], [row]]
+    stripeMock.subscriptions.retrieve.mockResolvedValue(
+      stripeItem({ quantity: 1, priceId: 'price_pro_month' })
+    )
+
+    await seatSyncHandler({ subscriptionId: 'sub-1' }, ctx)
+
+    expect(stripeMock.subscriptions.update).toHaveBeenCalledWith(
+      'stripe_sub',
+      expect.objectContaining({
+        items: [{ id: 'si_1', quantity: 2, price: 'price_team_month' }],
+        proration_behavior: 'always_invoice',
+      }),
+      expect.any(Object)
+    )
+  })
+
+  it('uses the annual price when the subscription bills yearly', async () => {
+    const row = {
+      plan: 'team_6000',
+      seats: 2,
+      status: 'active',
+      stripeSubscriptionId: 'stripe_sub',
+    }
+    queryQueue.value = [[row], [row]]
+    stripeMock.subscriptions.retrieve.mockResolvedValue(
+      stripeItem({ quantity: 1, priceId: 'price_pro_year', interval: 'year' })
+    )
+
+    await seatSyncHandler({ subscriptionId: 'sub-1' }, ctx)
+
+    expect(stripeMock.subscriptions.update).toHaveBeenCalledWith(
+      'stripe_sub',
+      expect.objectContaining({
+        items: [{ id: 'si_1', quantity: 2, price: 'price_team_year' }],
+      }),
+      expect.any(Object)
+    )
+  })
+
+  it('adjusts quantity only when the price already matches', async () => {
+    const row = {
+      plan: 'team_6000',
+      seats: 3,
+      status: 'active',
+      stripeSubscriptionId: 'stripe_sub',
+    }
+    queryQueue.value = [[row], [row]]
+    stripeMock.subscriptions.retrieve.mockResolvedValue(
+      stripeItem({ quantity: 2, priceId: 'price_team_month' })
+    )
+
+    await seatSyncHandler({ subscriptionId: 'sub-1' }, ctx)
+
+    const updateArg = stripeMock.subscriptions.update.mock.calls[0][1] as {
+      items: Array<{ price?: string; quantity: number }>
+    }
+    expect(updateArg.items[0].quantity).toBe(3)
+    expect(updateArg.items[0].price).toBeUndefined()
+  })
+
+  it('does nothing when price and quantity are already in sync', async () => {
+    const row = {
+      plan: 'team_6000',
+      seats: 2,
+      status: 'active',
+      stripeSubscriptionId: 'stripe_sub',
+    }
+    queryQueue.value = [[row], [row]]
+    stripeMock.subscriptions.retrieve.mockResolvedValue(
+      stripeItem({ quantity: 2, priceId: 'price_team_month' })
+    )
+
+    await seatSyncHandler({ subscriptionId: 'sub-1' }, ctx)
+
+    expect(stripeMock.subscriptions.update).not.toHaveBeenCalled()
+  })
+
+  it('skips non-Team subscriptions', async () => {
+    queryQueue.value = [
+      [{ plan: 'pro_6000', seats: 1, status: 'active', stripeSubscriptionId: 's' }],
+    ]
+
+    await seatSyncHandler({ subscriptionId: 'sub-1' }, ctx)
+
+    expect(stripeMock.subscriptions.retrieve).not.toHaveBeenCalled()
+    expect(stripeMock.subscriptions.update).not.toHaveBeenCalled()
+  })
+})