import { type DdnsConfigField } from '../types.js';
/** Per-provider runtime dependencies (fetch override for tests). */
export interface DdnsProviderDeps {
    fetch: typeof fetch;
}
/**
 * DDNS provider interface. Each provider knows:
 *   - Its display name + the fields needed to configure it (which fields are
 *     secrets vs. plain config goes into the SecretsStore / nat.json split).
 *   - How to push an IP update to the provider's API.
 *
 * v1 ships DuckDNS only. New providers drop in by exporting a `DdnsProvider`
 * and adding an entry to `BUILTIN_PROVIDERS`.
 */
export interface DdnsProvider {
    readonly id: string;
    readonly displayName: string;
    readonly configFields: ReadonlyArray<DdnsConfigField>;
    /**
     * The fully qualified name the provider publishes for a hostname as the user
     * typed it. Stored in place of the typed form because hosted nodes announce the
     * stored hostname as `/dns4/<hostname>`, so it has to resolve on its own.
     */
    qualifyHostname(hostname: string): string;
    /** Push `ip` for `hostname`. Throws NatError(ddns_update_failed) on failure. */
    update(config: Record<string, string>, hostname: string, ip: string, deps: DdnsProviderDeps): Promise<void>;
}
/** Built-in DDNS providers. */
export declare const BUILTIN_PROVIDERS: Readonly<Record<string, DdnsProvider>>;
/** Look up a provider by ID, throwing NatError(ddns_provider_unknown) if missing. */
export declare function getProvider(providerId: string): DdnsProvider;
/** List all built-in providers. */
export declare function listProviders(): DdnsProvider[];
export { duckDnsProvider } from './duckdns.js';
export { DdnsUpdater } from './updater.js';
export type { DdnsUpdaterOptions, DdnsUpdateOutcome } from './updater.js';