/**
 * Copyright (c) 2026, Salesforce, Inc.,
 * All rights reserved.
 * For full license text, see the LICENSE.txt file
 */
import type { OrgAuth } from "./auth.js";
import { graphitiHome } from "./fs-utils.js";
export { graphitiHome };
/** API version used for display-only endpoints where no live connection is available
 *  to query the org's actual version (live requests use connection.getApiVersion()). */
export declare const DEFAULT_API_VERSION = "67.0";
/** Resolves the directory holding cached introspection JSON files. */
export declare function schemaDir(): string;
/**
 * Strips Data Cloud (DLM/SSOT) types and their field references from a raw
 * introspection result.  Matches type names containing `__dlm` (case-insensitive)
 * or starting with `ssot__`.  Returns the mutated result and a count of removed types.
 */
export declare function stripDataCloudTypes(raw: any): {
    result: any;
    removedCount: number;
};
export declare function normalizeInstanceUrl(instanceUrl: string): string;
export declare function schemaCacheKeyForInstanceUrl(instanceUrl: string): string;
export declare function schemaExists(instanceUrl: string): boolean;
export interface SchemaMetadata {
    cacheKey: string;
    instanceUrl: string;
    typeCount: number;
    downloadedAt: string;
    filePath: string;
    strippedDataCloudTypes?: number;
}
export declare function getSchemaMetadata(instanceUrl: string): SchemaMetadata | null;
export declare function listCachedSchemas(): SchemaMetadata[];
export declare function downloadSchema(auth: OrgAuth): Promise<SchemaMetadata>;
export declare function loadIntrospectionResult(instanceUrl: string): any;
/** Returns the absolute path to the cached introspection JSON file. */
export declare function getSchemaFilePath(instanceUrl: string): string;
export declare function executeGraphQL(auth: OrgAuth, query: string, variables?: Record<string, unknown>): Promise<any>;