Server
Server Utils
Server-side composables for accessing feature flags.
Two server utilities are auto-imported in the server/ directory.
useUnleashFlags
Reads flags from storage with stale-while-revalidate. Use this in server routes, middleware, or API handlers.
server/api/my-route.ts
export default defineEventHandler(async () => {
const { toggles } = await useUnleashFlags()
if (toggles['premium-api']?.enabled) {
return { tier: 'premium', data: getPremiumData() }
}
return { tier: 'free', data: getFreeData() }
})
Type
function useUnleashFlags(): Promise<CachedFlags>
interface CachedFlags {
toggles: Record<string, EvaluatedFlag>
lastUpdated: number
}
refreshUnleashFlags
Force a refresh of flags from the Unleash Proxy. Useful for webhooks or admin endpoints.
server/api/refresh-flags.ts
export default defineEventHandler(async () => {
await refreshUnleashFlags({ force: true })
return { ok: true }
})
Type
function refreshUnleashFlags(options?: {
force?: boolean
}): Promise<CachedFlags | null>
force
boolean
Skip the deduplication lock and force a fresh fetch.