Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

1.8 KB
Raw Blame
/**
 * Dependency-free bridge to the feature-flag resolver (#10692).
 *
 * Pure-data registries such as `open-sse/config/imageRegistry.ts` are reachable
 * from client bundles (media page, provider detail page), so they must never
 * statically import `@/shared/utils/featureFlags` — that module reads the SQLite
 * override table through `@/lib/db/core`. Instead, `featureFlags.ts` registers
 * its resolver here when it loads on the server (it is loaded by `@/lib/db/core`,
 * so every DB-backed request path has it), and the registries ask this bridge.
 *
 * The resolver lives on `globalThis` so duplicated module instances (route
 * bundles vs. instrumentation) still see the same registration.
 */
import { sharedSymbol } from "@/shared/utils/processSingleton";

type FeatureFlagResolver = (key: string) => boolean;

const RESOLVER_KEY = sharedSymbol("featureFlagResolver");

type ResolverStore = { [RESOLVER_KEY]?: FeatureFlagResolver };

export function registerFeatureFlagResolver(resolver: FeatureFlagResolver | null): void {
  const store = globalThis as ResolverStore;
  if (resolver) store[RESOLVER_KEY] = resolver;
  else delete store[RESOLVER_KEY];
}

function isTruthyFlagValue(value: string | undefined): boolean {
  return value === "true" || value === "1" || value === "yes";
}

/**
 * Resolve a boolean feature flag through the registered server resolver
 * (DB override > env > definition default). Without a registered resolver
 * (client bundle, or before the server resolver loaded) it falls back to the
 * environment variable only.
 */
export function resolveRegisteredFeatureFlag(key: string): boolean {
  const resolver = (globalThis as ResolverStore)[RESOLVER_KEY];
  if (resolver) return resolver(key);
  const env = typeof process !== "undefined" ? process.env?.[key] : undefined;
  return isTruthyFlagValue(env);
}