import { Observable } from "rxjs";
import { NostrEvent } from "../helpers/event.js";
import type { ProfilePointer } from "../helpers/pointers.js";
import { ChainableObservable } from "../observable/chainable.js";
import { CastRefEventStore } from "./cast.js";
export type PubkeyCastConstructor<C extends PubkeyCast> = (new (pointer: ProfilePointer, store: CastRefEventStore) => C) & {
    cache?: Map<string, WeakRef<C>>;
    cacheRegistry?: FinalizationRegistry<string>;
};
/**
 * Cast a pubkey to a specific class instance.
 * Works like {@link castUser} - returns a cached singleton per pubkey+relay-hints combination.
 *
 * @note Instances are held weakly so unused casts can be garbage collected instead of
 * accumulating one instance per pubkey for the lifetime of the process.
 */
export declare function castPubkey<C extends PubkeyCast>(pubkey: string | NostrEvent | ProfilePointer, cls: PubkeyCastConstructor<C>, store: CastRefEventStore): C;
/** Base class for pubkey-based casts (analogous to {@link EventCast} for events) */
export declare class PubkeyCast {
    #private;
    readonly pointer: ProfilePointer;
    readonly store: CastRefEventStore;
    /** A global cache of pubkey -> weak instance reference, populated by {@link castPubkey} */
    static cache: Map<string, WeakRef<PubkeyCast>>;
    /** Cleans up dead {@link cache} entries when their instances are garbage collected */
    static cacheRegistry?: FinalizationRegistry<string>;
    constructor(pointer: ProfilePointer, store: CastRefEventStore);
    /** The hex pubkey represented by this cast */
    get pubkey(): string;
    /** Internal method for creating a cached observable reference */
    protected $$ref<Return extends unknown>(key: string, builder: (store: CastRefEventStore) => Observable<Return>): ChainableObservable<Return>;
}