<SuperflagProvider clientKey="pub_..." ttlSeconds={60}>
  <App />
</SuperflagProvider>

const value = useFlag<T>(name: string, fallback?: T): T | undefined

// Boolean flag
const enabled = useFlag('feature-enabled', false)

// String flag
const theme = useFlag<string>('theme', 'light')

// Number flag
const limit = useFlag<number>('rate-limit', 100)

// JSON flag
const config = useFlag<{ api: string }>('api-config', { api: '/v1' })

const state = useFlags(): SuperflagState

import { useFlags } from '@superflag-sh/react-native'
import { ActivityIndicator, Text, View } from 'react-native'

function MyScreen() {
  const { ready, loading, error, flags } = useFlags()

  if (loading) return <ActivityIndicator />
  if (error) return <Text>Error: {error}</Text>
  if (!ready) return <View />

  return <Text>Loaded {Object.keys(flags).length} flags</Text>
}

type SuperflagStatus = "idle" | "loading" | "ready" | "error" | "rate-limited"

interface SuperflagState {
  flags: Flags
  status: SuperflagStatus
  version: number | null
  etag: string | null
  lastFetchedAt: number | null
  error: string | null
}

type Flags = Record<string, FlagValue>

interface FlagValue {
  type: "bool" | "string" | "number" | "json"
  value: boolean | string | number | object
}

interface SuperflagProviderProps {
  clientKey?: string
  ttlSeconds?: number
  children: React.ReactNode
}

const CACHE_KEY = "superflag:cache:v1"

// Components
export { SuperflagProvider }

// Hooks
export { useFlag, useFlags }

// Types
export type {
  SuperflagStatus,
  SuperflagState,
  SuperflagProviderProps,
  Flags,
  FlagValue,
  FlagType
}

import {
  SuperflagProvider,
  useFlag,
  useFlags,
  type SuperflagState
} from '@superflag-sh/react-native'