import type { SObjectDescribe } from "./types.ts";
export type CacheEntry = {
    /** Schema version of the cached `describe` payload. Missing = pre-v2, reject. */
    schema?: number;
    fetchedAt: number;
    describe: SObjectDescribe;
};
export type CacheOptions = {
    orgId: string;
    ttlSeconds: number;
    cacheRoot?: string;
    bypass?: boolean;
};
/**
 * Filesystem-backed describe cache. Keyed by org-id + object name.
 *
 * Layout: <cacheRoot>/<orgId>/<objectName>.json
 *
 * The cache is intentionally dumb: no schema-version invalidation (phase 2+),
 * just wall-clock TTL. Bypass with `bypass: true`.
 */
export declare class DescribeCache {
    private readonly dir;
    private readonly ttlMillis;
    private readonly bypass;
    constructor(opts: CacheOptions);
    get(objectName: string): Promise<SObjectDescribe | null>;
    set(objectName: string, describe: SObjectDescribe): Promise<void>;
    private pathFor;
}