import type { LibSQLDatabase } from "drizzle-orm/libsql";
import type * as schema from "../../db/schema.js";
import { type OpenApiSpec } from "./types.js";
/**
 * Fetches and parses an OpenAPI specification from a configured URL.
 *
 * @NOTE Caching behavior is here for backwards compatibility with verions of the otel client library
 *       that do not support the `x-fpx-ignore` header.
 *       We can remove the cache once we know that all users have updated to a version of the otel client library
 *       that supports the `x-fpx-ignore` header (0.4.1+)
 *
 * @param db - The database instance to retrieve settings from
 * @param responseTtlMs - Cache time in milliseconds (defaults to CACHE_TTL_MS)
 *
 * @returns Promise that resolves to the parsed OpenAPI specification object, or null if:
 *          - No spec URL is configured
 *          - The URL cannot be resolved
 *          - The fetch request fails
 *          - The response cannot be parsed as JSON
 */
export declare function fetchOpenApiSpec(db: LibSQLDatabase<typeof schema>, responseTtlMs?: number): Promise<OpenApiSpec | null>;