Function sendOrganizationAlert

packages/billing/src/org-monitoring.ts:129–195

(
  params: OrganizationCreditAlert & {
    logger: Logger
  },
)

 * Sends alerts for organization credit issues
 */
export async function sendOrganizationAlert(
  params: OrganizationCreditAlert & {
    logger: Logger
  },
): Promise<void> {
  const {
    organizationId,
    alertType,
    currentBalance,
    threshold,
    usageAmount,
    error,
    metadata,
    logger,
  } = params

  try {
    // Log the alert
    logger.warn(
      {
        organizationId,
        alertType,
        currentBalance,
        threshold,
        usageAmount,
        error: error,
        metadata: metadata,
      },
      `Organization alert: ${alertType}`,
    )

    // Track analytics event
    trackEvent({
      event: AnalyticsEvent.CREDIT_GRANT,
      userId: organizationId,
      properties: {
        alertType,
        currentBalance,
        threshold,
      },
      logger,
    })

    // TODO: Implement actual alerting mechanisms:
    // - Email notifications to organization owners
    // - Slack/Discord webhooks
    // - Dashboard notifications
    // - SMS alerts for critical issues

    switch (alertType) {
      case 'low_balance':
        await handleLowBalanceAlert(params)
        break
      case 'high_usage':
        await handleHighUsageAlert(params)
        break
      case 'failed_consumption':
        await handleFailedConsumptionAlert(params)