Function computeOrgOverageAmount

apps/sim/lib/billing/core/billing.ts:172–210

(params: {
  plan: string | null
  seats: number | null
  periodStart: Date | null
  periodEnd: Date | null
  organizationId: string
  pooledCurrentPeriodCost: number
  departedMemberUsage: number
  memberIds: string[]
})

 * callers route through this to keep the overage math in one place.
 */
export async function computeOrgOverageAmount(params: {
  plan: string | null
  seats: number | null
  periodStart: Date | null
  periodEnd: Date | null
  organizationId: string
  pooledCurrentPeriodCost: number
  departedMemberUsage: number
  memberIds: string[]
}): Promise<{
  effectiveUsage: number
  baseSubscriptionAmount: number
  dailyRefreshDeduction: number
  totalOverage: number
}> {
  const totalUsage = params.pooledCurrentPeriodCost + params.departedMemberUsage

  let dailyRefreshDeduction = 0
  const planDollars = getPlanTierDollars(params.plan)
  if (planDollars > 0 && params.periodStart && params.memberIds.length > 0) {
    const userBounds = await getOrgMemberRefreshBounds(params.organizationId, params.periodStart)
    dailyRefreshDeduction = await computeDailyRefreshConsumed({
      userIds: params.memberIds,
      periodStart: params.periodStart,
      periodEnd: params.periodEnd ?? null,
      planDollars,
      seats: params.seats || 1,
      userBounds: Object.keys(userBounds).length > 0 ? userBounds : undefined,
      billingEntity: { type: 'organization', id: params.organizationId },
    })
  }

  const effectiveUsage = Math.max(0, totalUsage - dailyRefreshDeduction)
  const { basePrice } = getPlanPricing(params.plan ?? '')
  const baseSubscriptionAmount = (params.seats || 1) * basePrice
  const totalOverage = Math.max(0, effectiveUsage - baseSubscriptionAmount)

  return { effectiveUsage, baseSubscriptionAmount, dailyRefreshDeduction, totalOverage }
}

/**
 * Calculate overage amount for a subscription