import type * as ynab from "ynab";
/** Default TTL: 1 hour. External changes are picked up after this period. */
export declare const CACHE_TTL_MS: number;
export interface SyncDeltas {
    added: number;
    updated: number;
    deleted: number;
}
export interface CollectionCache<T> {
    byId: Map<string, T>;
    serverKnowledge?: number;
    stale: boolean;
    lastRefreshedAt: number;
    lastDeltas?: SyncDeltas;
}
export interface TransactionCache {
    byId: Map<string, ynab.TransactionDetail>;
    coveredSinceDate: string;
    serverKnowledge?: number;
    stale: boolean;
    lastRefreshedAt: number;
    lastDeltas?: SyncDeltas;
}
export interface SimpleCache<T> {
    data: T;
    lastRefreshedAt: number;
}
export type StaleableCollectionKey = "accounts" | "categories" | "payees" | "scheduledTransactions" | "transactions";
export interface BudgetCache {
    accounts: CollectionCache<ynab.Account>;
    categories: CollectionCache<ynab.Category>;
    payees: CollectionCache<ynab.Payee>;
    scheduledTransactions: CollectionCache<ynab.ScheduledTransactionDetail>;
    transactions: TransactionCache;
    categoryGroups: Map<string, ynab.CategoryGroupWithCategories>;
    settings?: SimpleCache<ynab.PlanSettings>;
    monthSummaries: Map<string, SimpleCache<ynab.MonthDetail>>;
    monthCategories: Map<string, SimpleCache<ynab.Category>>;
}
/**
 * Manages all per-budget caches (collection caches with delta sync, simple
 * TTL caches, optimistic updates) plus the top-level plans cache.
 *
 * This is an internal implementation detail of {@link YnabClient}; the public
 * API surface of the client is unchanged.
 */
export declare class CacheManager {
    private readonly budgetCaches;
    plansCache: SimpleCache<ynab.PlanSummary[]> | undefined;
    getBudgetCache(budgetId: string): BudgetCache;
    markCollectionsStale(budgetId: string, keys: StaleableCollectionKey[]): void;
    invalidateMonthCaches(budgetId: string): void;
    isSimpleCacheValid<T>(cache: SimpleCache<T> | undefined): cache is SimpleCache<T>;
    needsRefresh(cache: {
        stale: boolean;
        lastRefreshedAt: number;
        serverKnowledge?: number;
    }): boolean;
    optimisticUpdateTransactions(budgetId: string, transactions: ynab.TransactionDetail[]): void;
    optimisticRemoveTransaction(budgetId: string, transactionId: string): void;
    optimisticUpdateScheduledTransaction(budgetId: string, transaction: ynab.ScheduledTransactionDetail): void;
    optimisticRemoveScheduledTransaction(budgetId: string, scheduledTransactionId: string): void;
    applyAccountDeltas(budgetId: string, accounts: ynab.Account[], serverKnowledge: number): ynab.Account[];
    applyCategoryDeltas(budgetId: string, categoryGroups: ynab.CategoryGroupWithCategories[], serverKnowledge: number): ynab.CategoryGroupWithCategories[];
    applyPayeeDeltas(budgetId: string, payees: ynab.Payee[], serverKnowledge: number): ynab.Payee[];
    applyScheduledTransactionDeltas(budgetId: string, transactions: ynab.ScheduledTransactionDetail[], serverKnowledge: number): ynab.ScheduledTransactionDetail[];
    applyFullTransactionFetch(budgetId: string, transactions: ynab.TransactionDetail[], sinceDate: string, serverKnowledge: number): void;
    applyTransactionDeltas(budgetId: string, transactions: ynab.TransactionDetail[], serverKnowledge: number): void;
}