openrtc 1.0.6 → 1.0.8

package/dist/types-BCkKK8dy.d.ts

@@ -1,937 +0,0 @@
-interface AppLimits {
-    /** Max devices per authenticated user. -1 = unlimited. */
-    devicesPerUser: number;
-    /** Max total rooms the developer app can have open at once. -1 = unlimited. */
-    maxRooms: number;
-    /** Max members per room. -1 = unlimited. */
-    maxMembersPerRoom: number;
-    /** Max active devices across all provisioned spaces for this app. -1 = unlimited. */
-    maxPersonalDevices: number;
-}
-interface PlutoRTCConfiguration extends RTCConfiguration {
-    iceServers?: RTCIceServer[];
-    /**
-     * Populate public STUN defaults when no ICE servers are configured.
-     * Set to false with `iceServers: []` for an intentional host-only lane.
-     */
-    useDefaultIceServers?: boolean;
-    privacyMode?: boolean;
-    useTurn?: boolean;
-    /** Prefer host/srflx ICE candidates and upgrade aggressively on LAN. */
-    lanMode?: boolean;
-}
-interface LocalPeerSnapshot {
-    nodeId: string;
-    discoveredAtMs: number;
-    localReachable: boolean;
-}
-interface PlutoMoQServerCertificateHash {
-    algorithm: 'sha-256';
-    value: ArrayBuffer;
-}
-interface PlutoMoQConfiguration {
-    relayUrl?: string;
-    /** Relay JWT appended only at WebTransport connection time. Never include it in relayUrl. */
-    accessToken?: string;
-    /** Explicit certificate pins for self-signed development relays. */
-    serverCertificateHashes?: PlutoMoQServerCertificateHash[];
-}
-interface PlutoIrohConfiguration {
-    relayOnly?: boolean;
-    relayTransportPolicy?: 'auto' | 'quicRequired' | 'websocketRequired';
-    persistenceMode?: 'persistent' | 'ephemeral';
-    /** Enable native iroh mDNS LAN discovery (native runtimes only). */
-    localDiscovery?: boolean;
-    /** When false, listen for LAN peers without advertising this endpoint. */
-    localDiscoveryMode?: 'active' | 'passive';
-}
-interface PlutoBleConfiguration {
-    /** Enable native BLE discovery + transport (native runtimes only). */
-    enabled?: boolean;
-    /** Timeout for a single BLE connection attempt. */
-    connectTimeoutMs?: number;
-}
-interface TurnCredentials {
-    iceServers?: RTCIceServer[];
-}
-type TurnCredentialsProvider = () => Promise<TurnCredentials | null | undefined>;
-type DiscoveryMode = 'space' | 'user-scoped';
-type AuthMode = 'external' | 'anonymous' | 'required';
-type SignalingMode = 'hosted' | 'ticket-only';
-type RoomCreationMode = 'client-open' | 'client-auth' | 'server-only';
-type EndpointKind = 'device' | 'ephemeral';
-type PeerLifecycleStatus = 'disconnected' | 'connecting' | 'connected' | 'failed' | 'closed';
-type PeerHealth = 'unknown' | 'healthy' | 'suspect' | 'stale';
-type DevicePresenceStatus = 'online' | 'idle' | 'offline';
-type PeerLifecycleStage = 'discovered' | 'dialing' | 'base-connected' | 'admitted' | 'protocol-ready' | 'upgrading' | 'webrtc-ready' | 'degraded' | 'reconnecting' | 'closed';
-type PeerBaseTransportState = 'unknown' | 'connecting' | 'connected' | 'degraded' | 'closed';
-type PeerAdmissionState = 'unknown' | 'pending' | 'admitted' | 'rejected' | 'expired';
-type PeerWebRtcState = 'unknown' | 'disabled' | 'connecting' | 'transport-open' | 'route-probing' | 'ready' | 'failed' | 'closed';
-/**
- * Lifecycle label attached to a projected peer while the runtime tracks local ownership.
- *
- * This is not an admission grant. Use `GrantScope` for ticket/token authorization labels
- * such as `"share"`, `"friend"`, or `"user-device"`.
- */
-type PeerScope = 'persistent' | 'session' | string;
-/**
- * Admission-grant label embedded in restricted compound tickets and session tokens.
- *
- * `GrantScope` controls authorization and bulk revoke behavior in the Rust admission layer.
- * It is distinct from `PeerScope`, which only labels local peer lifecycle ownership.
- */
-type GrantScope = string;
-type ChannelOwnership = 'shared' | 'exclusive';
-type ChannelPeerModel = 'device-first' | 'node-first' | 'anonymous-ticket';
-type ChannelRoutingMode = 'stream-envelope' | 'session-default';
-type ChannelReadinessMode = 'settled-peer' | 'transport-only';
-type ChannelPromotionPolicy = 'eligible' | 'never';
-type ChannelSignalingPolicy = 'hosted' | 'ticket-only';
-interface ChannelDescriptor {
-    id: string;
-    kind: 'system' | 'auth' | 'share' | 'transfer' | 'sync' | string;
-    ownership: ChannelOwnership;
-    peerModel: ChannelPeerModel;
-    routing: ChannelRoutingMode;
-    readiness: ChannelReadinessMode;
-    promotionPolicy?: ChannelPromotionPolicy;
-    signalingPolicy?: ChannelSignalingPolicy;
-    description?: string;
-}
-type ProtocolName = 'iroh' | 'iroh-quic' | 'iroh-relay' | 'iroh-lan' | 'ble' | 'webrtc' | 'webrtc-lan' | 'webrtc-turn' | 'moq';
-type ProtocolMaturity = 'stable' | 'experimental' | 'unsupported';
-type ProtocolBaseName = 'iroh' | 'webrtc' | 'moq';
-type RouteFamily = 'iroh-path' | 'iroh-physical' | 'optional-route';
-type RouteImplementationKind = 'core' | 'host-installed' | 'route-adapter' | 'path-label';
-/**
- * Public compatibility type. `native` and `plugin` are legacy capability
- * labels; generated route descriptors use `RouteImplementationKind`.
- */
-type ProtocolImplementationKind = RouteImplementationKind | 'native' | 'plugin';
-type ProtocolLocality = 'nearby' | 'direct-internet' | 'relay' | 'mixed';
-interface RouteDescriptor {
-    id: ProtocolName;
-    baseProtocol: ProtocolBaseName;
-    family: RouteFamily;
-    implementation: RouteImplementationKind;
-    locality: ProtocolLocality;
-    maturity: ProtocolMaturity;
-    defaultRank: number;
-    browser: boolean;
-    native: boolean;
-    independentlyInstantiable: boolean;
-}
-interface ProtocolCapability {
-    /** Canonical descriptor id; additive to the legacy capability shape. */
-    id?: ProtocolName;
-    /** Compatibility alias for `id`. */
-    protocol: ProtocolName;
-    baseProtocol: ProtocolBaseName;
-    /** Canonical route family; additive to the legacy capability shape. */
-    family?: RouteFamily;
-    implementation: ProtocolImplementationKind;
-    locality: ProtocolLocality;
-    maturity: ProtocolMaturity;
-    /** Canonical descriptor rank; additive to the legacy capability shape. */
-    defaultRank?: number;
-    /** Canonical implementation taxonomy; `implementation` retains legacy values. */
-    routeImplementation?: RouteImplementationKind;
-    /** Compatibility alias for `defaultRank`. */
-    preferredRank: number;
-    browser: boolean;
-    native: boolean;
-    /** Canonical descriptor flag; additive to the legacy capability shape. */
-    independentlyInstantiable?: boolean;
-    configured?: boolean;
-    available: boolean;
-    reason?: string;
-}
-type ProtocolCapabilityMap = Record<ProtocolName, ProtocolCapability>;
-/** Space discovery always uses namespace-scoped Firebase tokens. */
-type SpaceAuthMode = 'scoped-token';
-type SpaceTokenProvider = () => Promise<{
-    customToken: string;
-    uid?: string;
-} | null | undefined>;
-interface ClientOptions {
-    /**
-     * API key issued from the Pluto developer dashboard (https://api.openrtc.app/developer).
-     * The runtime derives its app namespace from this key.
-     */
-    apiKey?: string;
-    /**
-     * Discovery avenue for this runtime.
-     *
-     * Set this explicitly in new apps:
-     * - `space`: a small live shared namespace backed by scoped space tokens.
-     * - `user-scoped`: a signed-in user's durable owned-device roster.
-     *
-     * Rooms and ticket/share grants are separate layers. Do not use `space`
-     * as a generic account device list, and do not expect `user-scoped`
-     * discovery to show other users unless a room or explicit grant connects them.
-     */
-    discoveryMode?: DiscoveryMode;
-    /**
-     * Shared space name for `space` discovery mode. Use this for lightweight
-     * lobbies, demos, cursors, and other live-only collaboration surfaces.
-     * This is the beginner-facing name for `spaceKey`; if both are set,
-     * `spaceKey` wins.
-     */
-    space?: string;
-    /**
-     * Compatibility name for `space`. The SDK derives a namespace from
-     * apiKey + spaceKey, then authenticates with spaceTokenProvider.
-     *
-     * Prefer `space` in public app code. Only used when discoveryMode is
-     * `space`; ignored for user-scoped discovery.
-     */
-    spaceKey?: string;
-    /**
-     * Pre-minted session token from your backend (for managed modes).
-     * Your backend calls PlutoRTC's /v1/tokens endpoint and passes the token here.
-     */
-    sessionToken?: string;
-    authMode?: AuthMode;
-    /**
-     * Allows first-party demos to use hosted defaults when an API key is omitted.
-     * Product apps should pass an API key.
-     */
-    allowAnonymousHostedDefaults?: boolean;
-    signalingMode?: SignalingMode;
-    projectId?: string;
-    storagePrefix?: string;
-    deviceTTL?: number;
-    deviceName?: string;
-    /**
-     * Persistence of the app-facing logical device identity. Defaults to
-     * `persistent` in browsers so a reload updates one durable device record.
-     */
-    deviceIdPersistence?: 'persistent' | 'ephemeral';
-    /**
-     * Persistence of the Iroh endpoint secret/EndpointId. Browser runtimes
-     * default to `ephemeral` so each tab/process incarnation has an unambiguous
-     * transport identity. Native hosts may persist their endpoint explicitly.
-     */
-    endpointIdPersistence?: 'persistent' | 'ephemeral';
-    /**
-     * @deprecated Use `deviceIdPersistence` and `endpointIdPersistence`.
-     * When supplied, this legacy option remains an explicit override for both.
-     */
-    nodeIdPersistence?: 'persistent' | 'ephemeral';
-    secretKey?: string;
-    strictMode?: boolean;
-    /**
-     * Optional application-provided TURN credential loader.
-     *
-     * OpenRTC never needs long-lived TURN secrets in the client. When strict/privacy
-     * WebRTC needs relay candidates, provide a backend-backed loader that returns
-     * short-lived RTCIceServer entries. Leave unset for the production default of
-     * no paid TURN usage.
-     */
-    turnCredentialsProvider?: TurnCredentialsProvider;
-    localDeviceId?: string;
-    onDevices?: (devices: Device[]) => void;
-    onAutoConnect?: (devices: Device[]) => void;
-    onIncomingSession?: (session: SignalingSession) => Promise<void>;
-    transports?: {
-        iroh?: boolean | PlutoIrohConfiguration;
-        webrtc?: boolean | PlutoRTCConfiguration;
-        ble?: boolean | PlutoBleConfiguration;
-        moq?: boolean | PlutoMoQConfiguration;
-    };
-    transportPriority?: ProtocolName[];
-    /** Subscribe to native LAN peer discovery events. */
-    onLocalPeer?: (peer: LocalPeerSnapshot) => void;
-    disableIrohFallback?: boolean;
-    /**
-     * Optional application-layer payload envelope. When configured, OpenRTC
-     * protects public message/media payload bytes before they are handed to
-     * iroh, WebRTC, or MoQ and opens them before app callbacks fire.
-     */
-    applicationCrypto?: ApplicationPayloadCrypto;
-    /**
-     * When manual `applicationCrypto` is not set, peers must negotiate an
-     * ephemeral X25519 ECDH key during transport handshake. Disabling is not
-     * supported in secure deployments.
-     */
-    automaticApplicationKeyAgreement?: boolean;
-    /**
-     * @internal Overrides orphan drift grace windows for tests and diagnostics.
-     */
-    orphanReconciliationGrace?: {
-        tsConnectionMs?: number;
-        rustRecordMs?: number;
-    };
-    /**
-     * Mints a namespace-scoped Firebase custom token for space discovery.
-     * Required when `discoveryMode` is `space` and `space`/`spaceKey` is set.
-     * Use `spaceToken(...)` for browser demos and simple static sites.
-     */
-    spaceTokenProvider?: SpaceTokenProvider;
-}
-interface Device {
-    deviceId: string;
-    deviceName: string;
-    online: boolean;
-    ticket: string;
-    presenceStatus?: DevicePresenceStatus;
-    presenceUpdatedAt?: number;
-    presenceExpiresAt?: number;
-    connectable?: boolean;
-    kind?: EndpointKind | string;
-    nodeId?: string;
-    platformType?: string;
-    capabilities?: {
-        canHost?: boolean;
-        canSync?: boolean;
-        readOnly?: boolean;
-        can_host?: boolean;
-        can_sync?: boolean;
-        read_only?: boolean;
-    };
-    sessionId?: string;
-    userId?: string;
-    lastSeenAt?: any;
-    expiresAt?: any;
-    createdAt?: any;
-    updatedAt?: any;
-    metadata?: string;
-    excludedPeers?: string[];
-    availableTransports?: ProtocolName[];
-    transports?: ProtocolName[];
-}
-interface PeerState {
-    peerId: string;
-    deviceId?: string;
-    deviceIdHint?: string;
-    nodeId?: string;
-    connectionId?: string;
-    connectionIds: string[];
-    ticket?: string;
-    online?: boolean;
-    deviceName?: string;
-    platformType?: string;
-    status: PeerLifecycleStatus;
-    health: PeerHealth;
-    lifecycleStage?: PeerLifecycleStage;
-    generation?: number;
-    baseTransportState?: PeerBaseTransportState;
-    admissionState?: PeerAdmissionState;
-    transportState?: string;
-    protocolState?: string;
-    webrtcState?: PeerWebRtcState;
-    routable?: boolean;
-    activeTransportStableId?: number | null;
-    transportGeneration?: number;
-    routeGeneration?: number;
-    activeTransport?: ProtocolName;
-    fallbackTransport?: ProtocolName | null;
-    parallelTransport?: ProtocolName | null;
-    manualDisconnect?: boolean;
-    lastAuthoritativeEventAt?: number;
-    lastTransientEventAt?: number;
-    promotionEligible?: boolean;
-    scopes: PeerScope[];
-    lastSeenAt?: number;
-    error?: string;
-}
-interface BackendConnectionState {
-    connectionId: string;
-    deviceId?: string | null;
-    deviceIdHint?: string | null;
-    remoteNodeId?: string | null;
-    state: string;
-    transportState?: string;
-    protocolState?: string;
-    routable?: boolean;
-    activeTransport?: ProtocolName;
-    parallelTransport?: ProtocolName | null;
-    readinessState?: string;
-    readinessReason?: string;
-    transportGeneration?: number;
-    routeGeneration?: number;
-    activeTransportStableId?: number | null;
-    replacementInProgress?: boolean;
-    lastLifecycleTransitionAtMs?: number;
-    transitionCount?: number;
-    connectingTransitionCount?: number;
-    replacementCount?: number;
-    retireCount?: number;
-    lastDisconnectReason?: string | null;
-    lastReconnectReason?: string | null;
-    error?: string;
-    createdAt?: number;
-    updatedAt?: number;
-}
-interface NativeConnectResult {
-    connectionId: string;
-    deviceId?: string | null;
-    deviceIdHint?: string | null;
-    remoteNodeId?: string | null;
-    state: string;
-    approvedScope?: string | null;
-}
-interface NativeConnectParams {
-    deviceId?: string | null;
-    endpointTicket: string;
-    /** Total native dial/admission budget. The host command must enforce it. */
-    timeoutMs?: number;
-}
-interface BackendPeerBiStream {
-    readable: ReadableStream<Uint8Array>;
-    writable: WritableStream<Uint8Array>;
-}
-interface BackendPeerUniStream {
-    writable: WritableStream<Uint8Array>;
-}
-interface IncomingStreamChannelMetadata {
-    channelId: string;
-    metadata?: Record<string, unknown> | null;
-}
-interface LocalDeviceInfo {
-    deviceId: string;
-    deviceName: string;
-    platformType?: string;
-    capabilities?: Device['capabilities'];
-    lastSeenAt?: string;
-}
-interface NativeManagedSessionStartResult {
-    localNodeId: string | null;
-    ticket?: string | null;
-    ticketScope?: string | null;
-    presenceStarted: boolean;
-    autoConnectStarted: boolean;
-    localDevice?: LocalDeviceInfo | null;
-}
-interface RoomMember {
-    nodeId: string;
-    userId: string;
-    ticket: string;
-    joinedAt: number;
-    lastSeenAt: number;
-    expiresAt?: number;
-}
-interface JoinRoomOptions {
-    bootstrapPeers?: boolean;
-}
-interface SignalingEnvelope {
-    name?: string;
-    appTag?: string;
-    senderId: string;
-    targetId: string;
-    senderUserId?: string;
-    targetUserId?: string;
-    state?: string;
-    payload: string;
-    replyPayload?: string;
-    timestamp?: number;
-    expiresAt?: number;
-}
-interface SignalingSession {
-    connectionId: string;
-    initiator?: string;
-    target?: string;
-    initiatorDeviceId: string;
-    targetDeviceId: string;
-    connectionType?: string;
-    offer?: any;
-    offerE2ee?: any;
-    answer?: any;
-    answerE2ee?: any;
-    iceCandidates: any[];
-    initiatorNodeId?: string;
-    targetNodeId?: string;
-    initiatorEndpointAddr?: string;
-    targetEndpointAddr?: string;
-    intent?: string;
-    /**
-        * @deprecated Internal namespace metadata. Public integrations should not depend on `appTag`.
-        * Removal target: v0.2.0.
-     */
-    appTag?: string;
-    createdAt?: number;
-    expiresAt?: number;
-    state: string;
-}
-interface ScanningLoopOptions {
-    localDeviceId: string;
-    autoConnect?: boolean;
-    autoConnectDebounceMs?: number;
-    retryThrottleMs?: number;
-    tieBreaker?: (localDeviceId: string, remoteDeviceId: string) => boolean;
-    shouldSkipDevice?: (device: Device) => boolean;
-    isConnected?: (deviceId: string) => boolean;
-    isConnecting?: (deviceId: string) => boolean;
-    onDevices?: (devices: Device[]) => void;
-    onAutoConnect?: (device: Device) => Promise<void> | void;
-    onIncomingSession?: (session: SignalingSession) => Promise<void> | void;
-    hasProtectedConnectionIntent?: (deviceId: string) => boolean;
-    cleanupStaleConnection?: (deviceId: string) => Promise<void>;
-    allowIncomingNodeId?: (nodeId: string) => Promise<void>;
-    acceptIncomingSession?: (sessionId: string, initiatorDeviceId: string) => Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    onIncomingSessionAccepted?: (session: SignalingSession) => Promise<void> | void;
-}
-interface ScanningLoopHandle {
-    stop: () => void;
-}
-interface ConnectDeviceHooks {
-    getConnectionState?: (deviceId: string) => Promise<string | undefined> | string | undefined;
-    forceDisconnect?: (deviceId: string) => Promise<void>;
-    refreshState?: () => Promise<void>;
-    directConnect: (device: Device) => Promise<void>;
-    signalConnect: (params: {
-        localDeviceId: string;
-        targetDeviceId: string;
-        targetUserId?: string;
-        device: Device;
-    }) => Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    onConnected?: (device: Device) => Promise<void> | void;
-    onRetry?: (device: Device, attempt: number, delayMs: number) => void;
-}
-interface ConnectDeviceOptions {
-    localDeviceId: string;
-    targetUserId?: string;
-    maxRetries?: number;
-    initialBackoffMs?: number;
-}
-interface ConnectDeviceResult {
-    success: boolean;
-    skipped?: 'already-connecting' | 'missing-local-device-id';
-    error?: string;
-    attempts: number;
-}
-interface ManagedDeviceConnectOptions {
-    localDeviceId: string;
-    targetUserId?: string;
-    maxRetries?: number;
-    initialBackoffMs?: number;
-    onRetry?: (device: Device, attempt: number, delayMs: number) => void;
-    onConnected?: (device: Device) => void | Promise<void>;
-}
-interface DeviceStatusSnapshot extends Device {
-    /**
-     * Presence/liveness for the roster entry. This is separate from
-     * `connectionStatus`, which describes the runtime route to the peer.
-     */
-    presenceStatus: DevicePresenceStatus;
-    presenceUpdatedAt?: number;
-    presenceExpiresAt?: number;
-    connectable: boolean;
-    connectionStatus: PeerLifecycleStatus | 'online';
-    settledReady?: boolean;
-    readinessState?: string;
-    readinessReason?: string;
-    peerHealth: PeerHealth;
-    peerId?: string;
-    promotionEligible?: boolean;
-    scopes: PeerScope[];
-    connectionId?: string;
-    deviceIdHint?: string;
-    activeTransportStableId?: number | null;
-    transportGeneration?: number;
-    routeGeneration?: number;
-    activeTransport?: ProtocolName;
-    parallelTransport?: ProtocolName | null;
-    availableTransports?: ProtocolName[];
-    /** Latest transport-owned RTT sample for the active route. */
-    latencyMs?: number | null;
-    /** Passive RTT samples keyed by the exact usable route label. */
-    latencyByTransport?: TransportLatencySnapshot;
-}
-interface TransportLatencySnapshot {
-    webrtc?: number | null;
-    webrtcLan?: number | null;
-    webrtcTurn?: number | null;
-    iroh?: number | null;
-    irohLan?: number | null;
-    irohRelay?: number | null;
-    ble?: number | null;
-    moq?: number | null;
-}
-interface ManagedConnectionRecord {
-    connectionId: string;
-    nodeId?: string | null;
-    deviceId?: string | null;
-    deviceIdHint?: string | null;
-    endpointId?: string | null;
-    transportGeneration: number;
-    routeGeneration?: number;
-    transportStableId?: number | null;
-    transportSource?: string | null;
-    lastTransportChangeAtMs: number;
-    lastRouteChangeAtMs?: number;
-    state: string;
-    statusReason?: string | null;
-    transitionCount?: number;
-    connectingTransitionCount?: number;
-    replacementCount?: number;
-    retireCount?: number;
-    lastDisconnectReason?: string | null;
-    lastReconnectReason?: string | null;
-    createdAtMs: number;
-    updatedAtMs: number;
-}
-interface ResolvedPeerIdentity {
-    peerId?: string | null;
-    deviceId?: string | null;
-    deviceIdHint?: string | null;
-    nodeId?: string | null;
-}
-interface PeerSessionSnapshot {
-    peerId: string;
-    deviceId?: string | null;
-    deviceIdHint?: string | null;
-    nodeId?: string | null;
-    activeConnectionId?: string | null;
-    candidateConnectionIds: string[];
-    status: PeerLifecycleStatus;
-    health: PeerHealth;
-    settledReady?: boolean;
-    readinessState?: string;
-    activeTransportStableId?: number | null;
-    transportGeneration?: number;
-    routeGeneration?: number;
-    activeTransport?: ProtocolName;
-    parallelTransport?: ProtocolName | null;
-    replacementPending?: boolean;
-    lastLifecycleTransitionAtMs?: number;
-    readinessReason?: string;
-    transitionCount?: number;
-    connectingTransitionCount?: number;
-    replacementCount?: number;
-    retireCount?: number;
-    lastDisconnectReason?: string | null;
-    lastReconnectReason?: string | null;
-    scopes: PeerScope[];
-    lastSeenAtMs: number;
-    error?: string | null;
-}
-interface RuntimeBootstrapOptions {
-    platform: 'native' | 'web';
-    initializeWeb?: () => Promise<void>;
-    isNativeReady?: () => Promise<boolean>;
-    retryNativeInit?: () => Promise<void>;
-    waitForNativeInitEvent?: (timeoutMs: number) => Promise<boolean>;
-    quickPollAttempts?: number;
-    quickPollIntervalMs?: number;
-    retryPollAttempts?: number;
-    retryPollIntervalMs?: number;
-    nativeInitEventTimeoutMs?: number;
-    initializeClient?: boolean;
-}
-interface RuntimeBootstrapResult {
-    ready: boolean;
-    mode: 'native' | 'web';
-}
-interface RuntimeIdentity {
-    id: string;
-    email?: string | null;
-    displayName?: string | null;
-    isAnonymous?: boolean;
-    getToken?: (forceRefresh?: boolean) => Promise<string | null>;
-}
-type DeviceEvent = {
-    type: 'added';
-    device: Device;
-} | {
-    type: 'modified';
-    device: Device;
-} | {
-    type: 'removed';
-    deviceId: string;
-};
-type SessionEvent = {
-    type: 'added';
-    session: SignalingSession;
-} | {
-    type: 'modified';
-    session: SignalingSession;
-} | {
-    type: 'removed';
-    sessionId: string;
-};
-interface ExplicitFileDataSendParams {
-    connectionId?: string;
-    connection?: {
-        send: (message: unknown) => Promise<void>;
-        deviceId?: string;
-        remoteNodeId?: string;
-        requireApplicationCrypto?: boolean;
-        getUpgradeState?: () => string;
-        isWebRtcApplicationRouteReady?: () => boolean;
-        sendOnWebRTC?: (data: Uint8Array) => Promise<void>;
-        getWebRTCTransport?: () => {
-            getBufferedAmount?: () => number;
-            waitForDrain?: (lowWaterMark: number) => Promise<void>;
-        } | null;
-    };
-    remoteNodeId?: string;
-    file: File;
-    transferId: string;
-    channelId?: string;
-    receiverPlatformType?: string | null;
-    applicationCrypto?: ApplicationPayloadCrypto;
-    requireApplicationCrypto?: boolean;
-}
-interface ISignalingBackend {
-    currentUser: RuntimeIdentity | null;
-    signInAnonymously(): Promise<void>;
-    signInWithPluto?(): Promise<void>;
-    signOut(): Promise<void>;
-    stopAuthScopedActivity?(): Promise<void>;
-    getTurnCredentials(): Promise<any>;
-    updatePresence(localNodeId: string, ticketStr: string, isOnline: boolean, ttlMs: number, metadata?: string): Promise<void>;
-    refreshLivePresence?(localNodeId: string, ticketStr: string, metadata?: string): Promise<void>;
-    setOffline(localNodeId: string): Promise<void>;
-    cleanupStaleDevices(): Promise<void>;
-    searchDevices(excludeNodeId?: string): Promise<Device[]>;
-    listDevicesWithStatus?(): Promise<DeviceStatusSnapshot[]>;
-    getPeerSession?(id: string): Promise<PeerSessionSnapshot | null>;
-    listPeerSessions?(): Promise<PeerSessionSnapshot[]>;
-    waitForSettledPeer?(id: string, timeoutMs?: number): Promise<PeerSessionSnapshot | null>;
-    resolvePeerIdentity?(id: string): Promise<ResolvedPeerIdentity>;
-    resolvePeerConnectionRecords?(id: string): Promise<ManagedConnectionRecord[]>;
-    updateDevice(deviceId: string, updates: {
-        deviceName?: string;
-        capabilities?: Device['capabilities'];
-        metadata?: string;
-    }): Promise<void>;
-    deleteDevice(deviceId: string): Promise<void>;
-    onDevicesChange(callback: (devices: Device[]) => void, excludeNodeId?: string): () => void;
-    onAuthChange(callback: (user: RuntimeIdentity | null) => void): () => void;
-    checkForSSOToken(): Promise<void>;
-    waitForAuth(): Promise<void>;
-    sendMessage(targetId: string, payload: string, state?: string, replyPayload?: string): Promise<string>;
-    pollMessages(targetId: string): Promise<SignalingEnvelope[]>;
-    subscribeDevices(userId: string): Promise<ReadableStream<DeviceEvent[]>>;
-    startAutoConnectOnce?(userId: string, localDeviceId: string): Promise<void>;
-    startAutoConnect(userId: string, localDeviceId: string): void;
-    notifyDisconnectRequested?(remoteNodeId: string): void;
-    startPresenceLoopOnce?(userId: string, localNodeId: string, deviceName: string, ticket: string, metadata?: string): Promise<void>;
-    startPresenceLoop(userId: string, localNodeId: string, deviceName: string, ticket: string, metadata?: string): void;
-    createSession(session: SignalingSession): Promise<void>;
-    updateSession(sessionId: string, updateData: any): Promise<void>;
-    subscribeSessions(localDeviceId: string): Promise<ReadableStream<SessionEvent[]>>;
-    forceReconnectSnapshot(): void;
-    getLocalDeviceId?(): Promise<string | null>;
-    getLocalDeviceInfo?(): Promise<LocalDeviceInfo | null>;
-    updateLocalDeviceName?(deviceName: string): Promise<LocalDeviceInfo | null>;
-    startManagedSessionNative?(options: {
-        userId: string;
-        deviceName?: string;
-        localDeviceId?: string | null;
-        metadata?: string;
-        autoConnect?: boolean;
-        presence?: boolean;
-    }): Promise<NativeManagedSessionStartResult>;
-    reconcileNativeManagedSession?(options?: {
-        reason?: string;
-    }): Promise<unknown>;
-    notifyNetworkChange?(options?: {
-        reason?: string;
-    }): Promise<unknown>;
-    getManagedNodeId?(options?: {
-        initializeIfMissing?: boolean;
-    }): Promise<string | null>;
-    getEndpointTicket?(): Promise<string>;
-    openPeerBi?(id: string, timeoutMs?: number): Promise<BackendPeerBiStream>;
-    openPeerNativeBi?(id: string, label: string, timeoutMs?: number): Promise<BackendPeerBiStream>;
-    openPeerUni?(id: string, timeoutMs?: number): Promise<BackendPeerUniStream>;
-    connectToDevice?(params: {
-        deviceId?: string | null;
-        endpointTicket: string;
-    }): Promise<NativeConnectResult>;
-    /**
-     * Optional backchannel so a backend (e.g. WasmBridge) can access the narrow
-     * facade surface needed to escalate runtime transport dials into registered
-     * TS connections.
-     */
-    setCoreClient?(client: CoreClientBridgeHost | null): void;
-    disconnectDevice?(deviceId: string): Promise<void>;
-    setAutoConnectExcluded?(deviceId: string, excluded: boolean): Promise<void>;
-    isConnected(nodeId: string): Promise<boolean>;
-    getConnectionStates?(): Promise<BackendConnectionState[]>;
-    onConnectionStateChange?(callback: (state: BackendConnectionState) => void): Promise<() => void> | (() => void);
-    /** @deprecated Implement file protocols over named channels, or use `openrtc-file-transfer`. */
-    sendExplicitFilePath?(connectionId: string, filePath: string, transferId?: string): Promise<string>;
-    /** @deprecated Implement file protocols over named channels, or use `openrtc-file-transfer`. */
-    sendExplicitFileData?(params: ExplicitFileDataSendParams): Promise<void>;
-    /** @deprecated Transfer history is consumer-owned application state. */
-    getTransferHistory?(limit?: number): Promise<Array<[string, unknown]>>;
-    /** @deprecated Transfer history is consumer-owned application state. */
-    deleteTransferJob?(jobId: string): Promise<void>;
-}
-interface CoreClientBridgeHost {
-    connect(ticket: string, timeoutMs?: number, expectedDeviceId?: string | null, channelId?: string, options?: {
-        admissionAlreadyPresented?: boolean;
-        approvedScope?: string | null;
-    }): Promise<{
-        id?: string | null;
-        remoteNodeId?: string | null;
-        deviceId?: string | null;
-    } | unknown>;
-    ensureManagedApplicationRoute?(options: ManagedApplicationRouteOptions): Promise<{
-        id?: string | null;
-        remoteNodeId?: string | null;
-        deviceId?: string | null;
-    } | unknown>;
-    waitForApplicationCryptoForPeer?(peerId?: string, timeoutMs?: number): Promise<unknown>;
-    hasApplicationRouteForPeer?(connectionId?: string, remoteNodeId?: string): boolean;
-    rememberRouteRepairTokenFromTicket?(ticket: string): Promise<boolean>;
-}
-interface ManagedApplicationRouteOptions {
-    ticket: string;
-    connectionId?: string | null;
-    remoteNodeId?: string | null;
-    expectedDeviceId?: string | null;
-    timeoutMs?: number;
-}
-interface SignalingOptions {
-    apiKey?: string;
-    authMode?: AuthMode;
-    projectId?: string;
-    storagePrefix?: string;
-    nodeIdPersistence?: 'persistent' | 'ephemeral';
-}
-interface TransportContext {
-    sendMoQ: (data: Uint8Array, options?: {
-        alreadyProtected?: boolean;
-    }) => Promise<void>;
-    /**
-     * Send one plaintext typed frame over a fresh runtime-owned Iroh application
-     * stream. The runtime applies the negotiated application-crypto stream
-     * envelope; callers must not pre-encrypt the frame a second time.
-     */
-    sendIrohApplicationFrame?: (frame: Uint8Array) => Promise<void>;
-    priorities: ProtocolName[];
-    /**
-     * Orders already-eligible route candidates through the Rust/WASM policy
-     * owner. This is a pure decision call: it must not dial, retry, promote,
-     * demote, or mutate connection state.
-     */
-    rankRoutes?: (candidates: ProtocolName[]) => ProtocolName[];
-    disableIrohFallback: boolean;
-    isMoQReady: () => boolean;
-    isMoQDataReady?: () => boolean;
-    isMoQApplicationRouteProven?: () => boolean;
-    requestMoQApplicationRouteProof?: () => void;
-    clearMoQApplicationRouteProof?: () => void;
-    runtimeFlow?: 'default' | 'ticket-only';
-    readerCloseStrategy?: 'cancel' | 'release-lock';
-}
-interface ApplicationPayloadCrypto {
-    /**
-     * When true, incoming application payloads that are not encrypted by this
-     * envelope are dropped before app callbacks fire.
-     */
-    requireEncrypted?: boolean;
-    protectPayload: (typeId: number, payload: Uint8Array) => Uint8Array;
-    openPayload: (expectedTypeId: number, payload: Uint8Array) => Uint8Array | null;
-}
-interface ApplicationCryptoBiStream {
-    send: WritableStream<Uint8Array>;
-    recv: ReadableStream<Uint8Array>;
-    endpoint_id?: string;
-}
-interface ApplicationCryptoStreamTools {
-    readonly typeId: number;
-    protectFrame: (payload: Uint8Array) => Uint8Array;
-    openFrame: (payload: Uint8Array) => Uint8Array | null;
-    createOutboundTransform: () => TransformStream<Uint8Array, Uint8Array>;
-    createInboundTransform: () => TransformStream<Uint8Array, Uint8Array>;
-    wrapReadable: (readable: ReadableStream<Uint8Array>) => ReadableStream<Uint8Array>;
-    wrapWritable: (writable: WritableStream<Uint8Array>) => WritableStream<Uint8Array>;
-    wrapBiStream: <T extends ApplicationCryptoBiStream>(stream: T) => T;
-}
-interface ApplicationPayloadReadinessOptions {
-    /**
-     * When provided, a connection is considered ready only once its active
-     * application route is one of these transports.
-     */
-    preferredTransports?: ProtocolName[];
-    /**
-     * If a preferred upgraded route cannot be established, allow the connection's
-     * proven application route to carry payloads instead of remaining pending.
-     */
-    allowFallbackAfterPreferredTransportFailure?: boolean;
-}
-interface ApplicationPayloadRouteOptions extends ApplicationPayloadReadinessOptions {
-    /**
-     * Include the parallel/fallback transport in diagnostic route listings.
-     * Normal app payload probes should leave this disabled so they measure the
-     * route OpenRTC would actually prefer for application data.
-     */
-    includeFallbackTransports?: boolean;
-}
-interface ApplicationPayloadSendOptions extends ApplicationPayloadRouteOptions {
-}
-interface ApplicationRouteReadyObservation {
-    connectionId: string;
-    remoteNodeId: string;
-    activeTransport: ProtocolName;
-    parallelTransport?: ProtocolName | null;
-    reason: 'webrtc-route-ready' | 'webrtc-heartbeat-healthy' | 'webrtc-application-send' | 'base-transport-loss-preserved';
-    transportStableId?: number;
-    transportGeneration?: number;
-    routeGeneration?: number;
-}
-interface ConnectionOptions {
-    reliable?: boolean;
-    rtcConfig?: PlutoRTCConfiguration;
-    transportContext?: TransportContext;
-    applicationCrypto?: ApplicationPayloadCrypto;
-    /**
-     * Whether the constructor's reader/writer represent a routable base
-     * application stream. Transport-only ticket channels set this to false:
-     * their placeholder streams exist only to satisfy the compatibility object,
-     * while application bytes use named runtime channels.
-     */
-    hasBaseApplicationStream?: boolean;
-    /** Framing used by the underlying iroh control stream. */
-    controlFrameMode?: 'typed' | 'native-main';
-    /**
-     * When true, public application payload sends wait for applicationCrypto to
-     * be installed and fail closed if key negotiation never completes.
-     * Internal handshake/control frames are sent through a separate control path.
-     */
-    requireApplicationCrypto?: boolean;
-    applicationCryptoWaitMs?: number;
-    onTransportStatusChange?: (status: {
-        activeTransport: ProtocolName;
-        parallelTransport?: ProtocolName | null;
-        transportStableId?: number;
-        transportGeneration?: number;
-        routeGeneration?: number;
-    }) => boolean | void | Promise<boolean | void>;
-    /**
-     * Fired when a connection-owned application route has proven it can carry
-     * app traffic. Consumers should use this as a lifecycle signal for the same
-     * connection record, not as an independent projection source.
-     */
-    onApplicationRouteReady?: (event: ApplicationRouteReadyObservation) => void;
-    /**
-     * Fired when the WebRTC data plane has proven a ping/pong round trip but the
-     * mandatory application crypto route is not installed yet. Connection owns
-     * transport proof; Client owns the application-route handshake recovery.
-     */
-    onApplicationRouteMissing?: (event: {
-        connectionId: string;
-        remoteNodeId: string;
-        reason: 'webrtc-heartbeat-before-crypto';
-        negotiationId?: string | null;
-    }) => void;
-}
-interface JoinRequest {
-    id: string;
-    userId: string;
-    ticket: string;
-    state: 'pending' | 'accepted' | 'rejected';
-}
-
-export type { RouteDescriptor as $, AuthMode as A, BackendPeerBiStream as B, ConnectDeviceResult as C, DiscoveryMode as D, ExplicitFileDataSendParams as E, PeerScope as F, GrantScope as G, DevicePresenceStatus as H, ISignalingBackend as I, JoinRoomOptions as J, PeerLifecycleStatus as K, LocalDeviceInfo as L, ManagedConnectionRecord as M, NativeManagedSessionStartResult as N, ProtocolCapability as O, PeerSessionSnapshot as P, ProtocolCapabilityMap as Q, ResolvedPeerIdentity as R, SignalingMode as S, TransportLatencySnapshot as T, ApplicationCryptoStreamTools as U, SpaceTokenProvider as V, AppLimits as W, ApplicationCryptoBiStream as X, ProtocolBaseName as Y, ProtocolImplementationKind as Z, ProtocolLocality as _, ConnectDeviceHooks as a, RouteFamily as a0, RouteImplementationKind as a1, SpaceAuthMode as a2, SignalingOptions as a3, RoomCreationMode as a4, ScanningLoopOptions as a5, ScanningLoopHandle as a6, RuntimeBootstrapOptions as a7, RuntimeBootstrapResult as a8, ManagedApplicationRouteOptions as a9, JoinRequest as aa, ConnectDeviceOptions as b, RuntimeIdentity as c, Device as d, DeviceStatusSnapshot as e, SignalingEnvelope as f, DeviceEvent as g, SignalingSession as h, SessionEvent as i, BackendPeerUniStream as j, NativeConnectParams as k, NativeConnectResult as l, BackendConnectionState as m, ClientOptions as n, ConnectionOptions as o, ApplicationPayloadCrypto as p, ApplicationPayloadReadinessOptions as q, ApplicationPayloadRouteOptions as r, ProtocolName as s, ApplicationPayloadSendOptions as t, ChannelDescriptor as u, IncomingStreamChannelMetadata as v, ManagedDeviceConnectOptions as w, PeerState as x, PeerHealth as y, RoomMember as z };