Function getRateLimitMessage

src/services/rateLimitMessages.ts:103–165

(
  limits: ClaudeAILimits,
  model: string,
)

 * Returns null if no message should be shown
 */
export function getRateLimitMessage(
  limits: ClaudeAILimits,
  model: string,
): RateLimitMessage | null {
  const sessionState = getCurrentRateLimitMessageSessionState()

  // Check overage scenarios first (when subscription is rejected but overage is available)
  // getUsingOverageText is rendered separately from warning.
  if (limits.isUsingOverage) {
    // Show warning if approaching overage spending limit
    if (limits.overageStatus === 'allowed_warning') {
      return {
        message: "You're close to your extra usage spending limit",
        severity: 'warning',
      }
    }
    return null
  }

  // ERROR STATES - when limits are rejected
  if (limits.status === 'rejected') {
    return {
      message: getLimitReachedText(limits, model, sessionState),
      severity: 'error',
    }
  }

  // WARNING STATES - when approaching limits with early warning
  if (limits.status === 'allowed_warning') {
    // Only show warnings when utilization is above threshold (70%)
    // This prevents false warnings after week reset when API may send
    // allowed_warning with stale data at low usage levels
    const WARNING_THRESHOLD = 0.7
    if (
      limits.utilization !== undefined &&
      limits.utilization < WARNING_THRESHOLD
    ) {
      return null
    }

    // Don't warn non-billing Team/Enterprise users about approaching plan limits
    // if overages are enabled - they'll seamlessly roll into overage
    const isTeamOrEnterprise =
      sessionState.subscriptionType === 'team' ||
      sessionState.subscriptionType === 'enterprise'

    if (
      isTeamOrEnterprise &&
      sessionState.hasExtraUsageEnabled &&
      !hasManagedPlanBillingAccess()
    ) {
      return null
    }

    const text = getEarlyWarningText(limits, sessionState)
    if (text) {
      return { message: text, severity: 'warning' }
    }