/**
 * SDNClient — unified client for Space Data Network nodes.
 *
 * Resolves nodes by various identifiers (PeerID, .onion, CID, IPNS, ENS, HTTP URL),
 * queries their data catalog, fetches/publishes SDS records, and manages channel subscriptions.
 */
import type { ResolvedNode, ResolveOptions, IdentifierType } from './resolver';
import { SDNTransportError } from './transport/http';
import type { NodeCatalog, SchemaCatalogEntry, DataQueryOptions, DataQueryStreamResult, DataQueryJsonResult, PublishResult, BatchPublishResult, LogHeadResponse, LogHeadsResponse, ChannelAccessOptions, ChannelActionResponse, ChannelGrantRequest, ChannelKeyEnvelopeRequest, ChannelKeyEnvelopeResponse, ChannelListOptions, ChannelMonitor, ChannelSummary } from './transport/http';
import type { AuthProvider } from './transport/auth';
import type { DerivedIdentity } from './crypto/types';
import type { ParsedEPM } from './epm-resolver';
/** Options for creating an SDNClient. */
export interface SDNClientOptions extends ResolveOptions {
    /** Pre-resolved HTTP base URL (skip resolution). */
    baseUrl?: string;
    /** Auth provider for authenticated requests. */
    authProvider?: AuthProvider;
}
export interface SDNClientChannels {
    list(options?: ChannelListOptions): Promise<ChannelSummary[]>;
    get(channelId: string, options?: ChannelAccessOptions): Promise<ChannelSummary>;
    subscribe(channelId: string, options?: ChannelAccessOptions): Promise<ChannelActionResponse>;
    unsubscribe(channelId: string, options?: ChannelAccessOptions): Promise<ChannelActionResponse>;
    publish(channelId: string, stream: Uint8Array, options?: ChannelAccessOptions): Promise<ChannelActionResponse>;
    grant(channelId: string, grant: ChannelGrantRequest, options?: ChannelAccessOptions): Promise<ChannelActionResponse>;
    issueGrant(channelId: string, grant: ChannelGrantRequest, options?: ChannelAccessOptions): Promise<ChannelActionResponse>;
    keyUnwrap(channelId: string, request: ChannelKeyEnvelopeRequest, options?: ChannelAccessOptions): Promise<ChannelKeyEnvelopeResponse>;
    openStream(channelId: string, options?: ChannelAccessOptions): Promise<Uint8Array>;
    moduleFeed(channelId: string, options?: ChannelAccessOptions): Promise<Uint8Array>;
    monitor(channelId: string, options?: ChannelAccessOptions): Promise<ChannelMonitor>;
}
/**
 * SDNClient provides a unified interface to interact with an SDN node:
 * - Discover the node via various identifier types
 * - Query its data catalog (what record types it publishes)
 * - Fetch data by schema, day, NORAD ID, entity ID
 * - Publish data (with authentication)
 *
 * @example
 * ```ts
 * // Resolve by domain
 * const client = await SDNClient.resolve('spaceaware.io');
 * const catalog = await client.catalog();
 * console.log(catalog.schemas);
 *
 * // Discover and monitor OMM channel data
 * const channels = await client.channels.list({ standardCode: 'OMM' });
 * const monitor = await client.channels.monitor(channels[0].channelId);
 *
 * // Authenticate and publish
 * await client.authenticate(identity);
 * await client.channels.publish('spaceaware-OMM', flatbufferStreamBytes);
 * ```
 */
export declare class SDNClient {
    /** The resolved node info. */
    readonly resolved: ResolvedNode;
    readonly channels: SDNClientChannels;
    private transport;
    private _catalog?;
    private constructor();
    /**
     * Resolve a node by any supported identifier and return a client.
     *
     * Supported identifiers:
     * - PeerID: `12D3KooW...`
     * - .onion: `abc...xyz.onion`
     * - HTTP: `https://spaceaware.io` or `spaceaware.io`
     * - Multiaddr: `/dns4/spaceaware.io/tcp/443`
     * - IPFS CID: `bafy...`
     * - IPNS: `k51...`
     * - ENS: `mynode.eth`
     */
    static resolve(identifier: string, opts?: SDNClientOptions): Promise<SDNClient>;
    /** Create a client from an explicit HTTP URL. */
    static fromUrl(url: string, opts?: SDNClientOptions): SDNClient;
    /** Create a client from a parsed EPM. */
    static fromEPM(epm: ParsedEPM): SDNClient | null;
    /** The node's HTTP base URL. */
    get baseUrl(): string;
    /** The node's PeerID, if known. */
    get peerId(): string | undefined;
    /** Fetch the node's schema catalog. */
    catalog(): Promise<NodeCatalog>;
    /** Get cached catalog (call catalog() first to populate). */
    get cachedCatalog(): NodeCatalog | undefined;
    /** List schema names this node publishes. Fetches catalog if not cached. */
    listSchemas(): Promise<string[]>;
    /**
     * Query data records (flatbuffers-first, loop D.3): ONE request to the
     * flow-served bulk endpoint; the DEFAULT result carries the aligned
     * size-prefixed FlatBuffer record stream verbatim (zero-copy `frames()`
     * iterator). Pass `format: 'json'` for the opt-in JSON edge adapter.
     */
    query(opts: DataQueryOptions & {
        format: 'json';
    }): Promise<DataQueryJsonResult>;
    query(opts: DataQueryOptions & {
        format?: 'flatbuffers';
    }): Promise<DataQueryStreamResult>;
    query(opts: DataQueryOptions): Promise<DataQueryStreamResult | DataQueryJsonResult>;
    /** Get a single record's raw FlatBuffer bytes by schema and CID. */
    get(schema: string, cid: string): Promise<Uint8Array | null>;
    /** Get node info (EPM + runtime metadata). */
    nodeInfo(): Promise<Record<string, unknown>>;
    /**
     * Authenticate with the node using an HD wallet identity.
     * Required before publishing data.
     */
    authenticate(identity: DerivedIdentity): Promise<void>;
    /** Publish a FlatBuffer record. Requires prior authenticate() call. */
    publish(schema: string, data: Uint8Array): Promise<PublishResult>;
    /** Publish multiple records in a batch. Requires prior authenticate() call. */
    publishBatch(schema: string, records: Uint8Array[]): Promise<BatchPublishResult>;
    /** Get the log head for a publisher+schema. */
    logHead(schema: string, publisherPeerID: string): Promise<LogHeadResponse>;
    /** Get all publishers' log heads for a schema. */
    logHeads(schema: string): Promise<LogHeadsResponse>;
}
export type { NodeCatalog, SchemaCatalogEntry, DataQueryOptions, DataQueryStreamResult, DataQueryJsonResult, PublishResult, BatchPublishResult, LogHeadResponse, LogHeadsResponse, ChannelAccessOptions, ChannelActionResponse, ChannelGrantRequest, ChannelKeyEnvelopeRequest, ChannelKeyEnvelopeResponse, ChannelListOptions, ChannelMonitor, ChannelSummary, ResolvedNode, ResolveOptions, IdentifierType, AuthProvider, };
export { SDNTransportError };
//# sourceMappingURL=client.d.ts.map