interface StorageQuota {
  entityId: string
  entityType: 'user' | 'channel' | 'team'
  limit: number // Total limit in bytes
  used: number // Current usage in bytes
  percentage: number // Usage percentage (0-100)
  softLimitThreshold: number // Warning threshold (default: 80%)
  softLimitExceeded: boolean // True if over soft limit
  hardLimitExceeded: boolean // True if over hard limit
  lastCalculated: Date // Last calculation timestamp
}

interface StorageUsageBreakdown {
  total: number
  byType: {
    messages: number
    files: number
    images: number
    videos: number
    audio: number
    documents: number
    archives: number
    code: number
    other: number
    cache: number
  }
  byUser?: Map<string, number>
  byChannel?: Map<string, number>
  largestFiles: Array<{...}>
  oldestFiles: Array<{...}>
}

interface QuotaWarning {
  id: string
  entityId: string
  entityType: 'user' | 'channel' | 'team'
  type: 'approaching' | 'exceeded' | 'critical'
  threshold: number
  message: string
  timestamp: Date
  acknowledged: boolean
}

interface CleanupPolicy {
  enabled: boolean
  deleteOlderThan?: number // Days
  compressImagesOlderThan?: number // Days
  archiveMessagesOlderThan?: number // Days
  deleteCacheOlderThan?: number // Days
  maintainFreeSpace?: number // Percentage
}

interface StorageStats {
  totalAllocated: number // Total storage limit
  totalUsed: number // Current usage
  totalAvailable: number // Remaining space
  fileCount: number // Total files
  userCount: number // Active users
  channelCount: number // Active channels
  averageFileSize: number // Avg file size
  largestFileSize: number // Largest file
  growthRate: number // Bytes/day
  daysUntilFull: number | null // Estimated days
}

// Get team statistics
const stats = await fetch('/api/storage?action=stats').then((res) => res.json())

// Get user quota
const quota = await fetch('/api/storage?action=quota&entityId=user-123&entityType=user').then(
  (res) => res.json()
)

// Check if upload allowed
const check = await fetch(
  '/api/storage?action=check-upload&entityId=user-123&entityType=user&fileSize=5242880'
).then((res) => res.json())

{
  action: string,
  entityId?: string,
  entityType?: 'user' | 'channel' | 'team',
  // Additional params based on action
}

{
  action: 'update-quota',
  entityId: 'user-123',
  entityType: 'user',
  newLimit: 10737418240 // 10 GB
}

{
  action: 'record-upload',
  entityId: 'user-123',
  entityType: 'user',
  fileSize: 5242880 // 5 MB
}

{
  action: 'record-deletion',
  entityId: 'user-123',
  entityType: 'user',
  fileSize: 5242880
}

{
  action: 'cleanup',
  entityId: 'user-123',
  entityType: 'user',
  policy: {
    enabled: true,
    deleteOlderThan: 90,
    compressImagesOlderThan: 30
  }
}

{
  action: 'optimize',
  entityId: 'team-1',
  entityType: 'team'
}

{
  action: 'delete-old-files',
  entityId: 'user-123',
  entityType: 'user',
  olderThanDays: 90
}

{
  action: 'archive-messages',
  entityId: 'channel-123',
  entityType: 'channel',
  olderThanDays: 180
}

{
  action: 'clear-cache',
  entityId: 'user-123',
  entityType: 'user'
}

{
  action: 'acknowledge-warning',
  warningId: 'user:user-123:approaching'
}

// Delete specific file
await fetch('/api/storage?entityId=user-123&entityType=user&fileId=file-456', { method: 'DELETE' })

// Clear all storage
await fetch('/api/storage?entityId=user-123&entityType=user', { method: 'DELETE' })

import { quotaManager } from '@/lib/storage/quota-manager'

async function handleFileUpload(userId: string, file: File) {
  // Check if upload is allowed
  const check = await quotaManager.canUpload(userId, 'user', file.size)

  if (!check.allowed) {
    console.error('Upload blocked:', check.reason)
    return
  }

  // Proceed with upload
  // ...

  // Record upload
  await quotaManager.recordUpload(userId, 'user', file.size)
}

import { StorageUsage } from '@/components/settings/StorageUsage'

export function SettingsPage() {
  return (
    <div>
      <h1>Settings</h1>
      <StorageUsage />
    </div>
  )
}

import { StorageManagement } from '@/components/admin/StorageManagement'

export function AdminStoragePage() {
  return (
    <div>
      <h1>Storage Management</h1>
      <StorageManagement />
    </div>
  )
}

import { formatBytes } from '@/lib/storage/quota-manager'

const size = 5242880 // bytes
console.log(formatBytes(size)) // "5 MB"
console.log(formatBytes(size, 0)) // "5 MB"
console.log(formatBytes(size, 3)) // "5.000 MB"

import { getQuotaStatus } from '@/lib/storage/quota-manager'

const used = 4.5 * 1024 * 1024 * 1024 // 4.5 GB
const limit = 5 * 1024 * 1024 * 1024 // 5 GB

const status = getQuotaStatus(used, limit)
// Returns: 'critical' (90% used)

// Status can be: 'ok' | 'warning' | 'critical' | 'exceeded'

interface StorageManagementProps {
  className?: string
}

interface StorageUsageProps {
  className?: string
}