Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

1.4 KB
Raw Blame
import type { Schemas } from '@/api/generated'
import type { Context } from '@/tools/types'

/**
 * Resolve a flag key through the list endpoint's `key` filter, which is a case-insensitive
 * exact match. It can return more than one flag only when two keys differ solely by case, so
 * the exact-case match is preferred when one exists. Misses and ambiguity are returned, not
 * thrown: each caller words them differently (a miss is data for the by-key lookups).
 *
 * The list hides archived flags unless `archived` is passed, and archiving an experiment
 * archives its flag, so a first-pass miss is retried against archived flags before it counts.
 */
export async function resolveFlagsByKey(
    context: Context,
    projectId: string,
    key: string
): Promise<Schemas.FeatureFlag[]> {
    const list = async (archived: boolean): Promise<Schemas.FeatureFlag[]> => {
        const page = await context.api.request<Schemas.PaginatedFeatureFlagList>({
            method: 'GET',
            path: `/api/projects/${encodeURIComponent(projectId)}/feature_flags/`,
            query: { key, limit: 20, ...(archived && { archived: true }) },
        })
        return page.results ?? []
    }
    let results = await list(false)
    if (results.length === 0) {
        results = await list(true)
    }
    const exact = results.filter((flag) => flag.key === key)
    return exact.length > 0 ? exact : results
}