openrtc 1.0.4 → 1.0.6

package/dist/framing-zRvEKOld.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Pure byte / stream / timing helpers.
+ *
+ * Extracted from the `Client` god object (see
+ * `docs/plans/client-ts-decomposition.md` Phase 1). These functions are
+ * deliberately pure — no `Client` state, no `this`, no logging side effects — so
+ * the same helper is reused everywhere instead of being re-implemented inline
+ * (e.g. `concatBytes` previously existed both here and in `applicationCrypto.ts`,
+ * and three near-identical exponential-backoff helpers existed across the class).
+ */
+
+type ByteArray = Uint8Array<ArrayBuffer>;
+type ByteArrayLike = Uint8Array<ArrayBufferLike>;
+
+type RuntimeU32BEFrameHandler = (payload: ByteArray) => void;
+type RuntimeJsonFrameHandler<T = unknown> = (value: T, payload: ByteArray) => void;
+interface RuntimeJsonFrameDecoderOptions {
+    onInvalidJson?: (error: unknown, payload: ByteArray) => void;
+}
+declare function encodeRuntimeU32BEFrame(payload: ByteArrayLike): ByteArray;
+declare function createRuntimeU32BEFrameDecoder(onFrame: RuntimeU32BEFrameHandler): (chunk: ByteArrayLike) => void;
+declare function encodeRuntimeJsonPayload(value: unknown): ByteArray;
+declare function decodeRuntimeJsonPayload<T = unknown>(payload: ByteArrayLike): T;
+declare function encodeRuntimeJsonFrame(value: unknown): ByteArray;
+declare function createRuntimeJsonFrameDecoder<T = unknown>(onValue: RuntimeJsonFrameHandler<T>, options?: RuntimeJsonFrameDecoderOptions): (chunk: ByteArrayLike) => void;
+declare function concatRuntimeBytes(a: ByteArrayLike, b: ByteArrayLike): ByteArray;
+declare function readRuntimeU32BE(bytes: ByteArrayLike, offset: number): number;
+
+export { type RuntimeJsonFrameHandler as R, type RuntimeU32BEFrameHandler as a, createRuntimeU32BEFrameDecoder as b, createRuntimeJsonFrameDecoder as c, decodeRuntimeJsonPayload as d, encodeRuntimeJsonFrame as e, encodeRuntimeJsonPayload as f, encodeRuntimeU32BEFrame as g, type RuntimeJsonFrameDecoderOptions as h, concatRuntimeBytes as i, readRuntimeU32BE as r };

package/dist/index.d.ts

@@ -1,269 +1,27 @@
-import { R as RuntimeClient, a as RuntimePolicySnapshot, P as PeerReconciliationStats, b as PlutoRuntimeAssembly } from './framing-rPdckqn5.js';
-export { O as OPENRTC_RUNTIME_POLICY, c as RuntimeJsonFrameHandler, d as RuntimeU32BEFrameHandler, S as ScopedSession, e as Session, f as SessionOptions, g as createRuntimeJsonFrameDecoder, h as createRuntimeU32BEFrameDecoder, i as decodeRuntimeJsonPayload, j as encodeRuntimeJsonFrame, k as encodeRuntimeJsonPayload, l as encodeRuntimeU32BEFrame, m as getRuntimePolicy } from './framing-rPdckqn5.js';
-import { l as ConnectDeviceResult, m as ConnectDeviceHooks, n as ConnectDeviceOptions, P as PeerSessionSnapshot, c as ResolvedPeerIdentity, G as GrantScope, o as ProtocolName, p as ProtocolCapability, q as ProtocolCapabilityMap, r as ApplicationPayloadCrypto, s as ApplicationCryptoStreamTools, t as SpaceTokenProvider } from './types-ByZyADCn.js';
-export { u as AppLimits, v as ApplicationCryptoBiStream, w as ApplicationPayloadReadinessOptions, x as ApplicationPayloadRouteOptions, y as ApplicationPayloadSendOptions, A as AuthMode, z as DevicePresenceStatus, D as DiscoveryMode, F as ProtocolBaseName, H as ProtocolImplementationKind, J as ProtocolLocality, K as RouteDescriptor, O as RouteFamily, Q as RouteImplementationKind, S as SignalingMode, T as SpaceAuthMode } from './types-ByZyADCn.js';
-import { A as AuthContext } from './IEngineBridge-C7OT2CRv.js';
-import { R as RuntimeClientOptions, a as RuntimeManagedSessionOptions, b as RuntimeManagedSession, c as RuntimeDevice, d as RuntimeDeviceStatusSnapshot, e as RuntimeDeviceConnectOptions, f as RuntimeLocalDeviceInfo, g as RuntimeLocalDeviceProfile, h as RuntimePeerState, i as RuntimePeerConnectOptions, C as Connection, j as RuntimePeerReadinessSnapshot, k as RuntimePeerHealth, l as RuntimeChannelDescriptor, m as RuntimePeerStreamOptions, n as RuntimeIncomingStream, o as RuntimeScopedChannelOptions, p as RuntimeScopedLogicalChannel, q as RuntimeJoinRoomOptions, r as RuntimeRoomMember, s as RuntimeConnectionStateSnapshot, t as RuntimeApplicationPayloadReadinessOptions, u as RuntimeConnectionEvent, v as RuntimeRawConnection, I as ITransport } from './device-status-CR27Ak7c.js';
-export { w as ChannelDescriptor, x as ConnectionEvent, y as ConnectionTarget, D as DeviceProfile, z as IncomingStream, P as PeerConnectOptions, A as PeerReadiness, B as PeerStreamOptions, E as PresenceLoopOptions, F as RawConnection, G as RuntimeAuthContext, H as RuntimeAuthIdentity, J as RuntimeAutoConnectPolicy, K as RuntimeConnectionTarget, L as RuntimeDevicePresenceStatus, M as RuntimeDeviceStatus, N as RuntimeLogicalChannelFraming, O as RuntimeManagedSessionKind, Q as RuntimeManagedSessionPlatform, S as RuntimePeerLifecycleStatus, T as RuntimePeerScope, U as RuntimePeerSessionSnapshot, V as RuntimePresenceLoopOptions, W as RuntimePresencePolicy, X as RuntimeSession, Y as RuntimeUiConnectionStatus, Z as ScopedChannelOptions, _ as ScopedLogicalChannel, $ as isRuntimeDeviceActive, a0 as isRuntimeDeviceConnectable, a1 as isRuntimeDeviceRoutable } from './device-status-CR27Ak7c.js';
-import { P as PlutoIpcBridge } from './IpcRuntimeAdapter-B8rkqNrq.js';
-import { R as RuntimeCapabilities, a as RuntimeCapabilityProfile } from './DelegatingRuntimeAdapter-D2_dgabz.js';
-export { b as RuntimeAdapterKind } from './DelegatingRuntimeAdapter-D2_dgabz.js';
+import { R as RuntimeClientOptions, I as ITransport } from './types-N9s66nF8.js';
+export { w as ChannelDescriptor, x as ConnectionEvent, y as ConnectionTarget, D as DeviceProfile, z as IncomingStream, P as PeerConnectOptions, A as PeerReadiness, B as PeerStreamOptions, E as PresenceLoopOptions, F as RawConnection, t as RuntimeApplicationPayloadReadinessOptions, G as RuntimeAuthContext, H as RuntimeAuthIdentity, J as RuntimeAutoConnectPolicy, l as RuntimeChannelDescriptor, u as RuntimeConnectionEvent, s as RuntimeConnectionStateSnapshot, K as RuntimeConnectionTarget, c as RuntimeDevice, e as RuntimeDeviceConnectOptions, L as RuntimeDevicePresenceStatus, M as RuntimeDeviceStatus, d as RuntimeDeviceStatusSnapshot, n as RuntimeIncomingStream, q as RuntimeJoinRoomOptions, f as RuntimeLocalDeviceInfo, g as RuntimeLocalDeviceProfile, N as RuntimeLogicalChannelFraming, b as RuntimeManagedSession, O as RuntimeManagedSessionKind, a as RuntimeManagedSessionOptions, Q as RuntimeManagedSessionPlatform, i as RuntimePeerConnectOptions, k as RuntimePeerHealth, S as RuntimePeerLifecycleStatus, j as RuntimePeerReadinessSnapshot, T as RuntimePeerScope, U as RuntimePeerSessionSnapshot, h as RuntimePeerState, m as RuntimePeerStreamOptions, V as RuntimePresenceLoopOptions, W as RuntimePresencePolicy, v as RuntimeRawConnection, r as RuntimeRoomMember, o as RuntimeScopedChannelOptions, p as RuntimeScopedLogicalChannel, X as RuntimeSession, Y as RuntimeUiConnectionStatus, Z as ScopedChannelOptions, _ as ScopedLogicalChannel } from './types-N9s66nF8.js';
+import { P as PlutoIpcBridge } from './ipc-CflAVodw.js';
+import { O as OpenRTCClient } from './spaceTokens-3sbs1mUF.js';
+export { E as EnableSpaceAuthResponse, M as MintSpaceTokenRequest, a as MintSpaceTokenResponse, b as OpenRTCChannelConnectOptions, c as OpenRTCDeviceNamespace, d as OpenRTCDeviceSessionOptions, e as OpenRTCRoomNamespace, f as OpenRTCTicketNamespace, g as createPublicSpaceTokenProvider, h as createSpaceTokenProvider, i as enableSpaceAuth, m as mintSpaceToken, s as sandboxSpaceKey, j as spaceToken } from './spaceTokens-3sbs1mUF.js';
+import { u as ProtocolName, U as ProtocolCapability, V as ProtocolCapabilityMap, r as ApplicationPayloadCrypto, W as ApplicationCryptoStreamTools } from './types-ZDsZknDI.js';
+export { X as AppLimits, Y as ApplicationCryptoBiStream, s as ApplicationPayloadReadinessOptions, t as ApplicationPayloadRouteOptions, v as ApplicationPayloadSendOptions, A as AuthMode, O as DevicePresenceStatus, D as DiscoveryMode, G as GrantScope, Z as ProtocolBaseName, _ as ProtocolImplementationKind, $ as ProtocolLocality, a0 as RouteDescriptor, a1 as RouteFamily, a2 as RouteImplementationKind, d as SignalingMode, S as SpaceAuthMode, a as SpaceTokenProvider } from './types-ZDsZknDI.js';
 export { ROUTE_DESCRIPTORS, TRANSPORT_LABELS, getRouteDescriptor, isDirectIrohTransportLabel, isIndependentTransportLabel, isIrohBaseTransportLabel, isOptionalTransportLabel, isWebRtcTransportLabel, listRouteDescriptors, normalizeTransportLabel } from './transport/index.js';
-import './runtime/WasmRuntimeAdapter.js';
+export { isRuntimeDeviceActive, isRuntimeDeviceConnectable, isRuntimeDeviceRoutable } from './runtime/device-status.js';
+export { R as RuntimeJsonFrameHandler, a as RuntimeU32BEFrameHandler, c as createRuntimeJsonFrameDecoder, b as createRuntimeU32BEFrameDecoder, d as decodeRuntimeJsonPayload, e as encodeRuntimeJsonFrame, f as encodeRuntimeJsonPayload, g as encodeRuntimeU32BEFrame } from './framing-zRvEKOld.js';
+export { O as OPENRTC_RUNTIME_POLICY, a as RuntimePolicySnapshot, S as ScopedSession, c as Session, d as SessionOptions, g as getRuntimePolicy } from './assembly-C2G0P2L5.js';
+export { b as RuntimeAdapterKind, R as RuntimeCapabilities } from './capabilities-C4Dqs_pB.js';
+import './IEngineBridge-C7OT2CRv.js';
 
-type OpenRTCChannelConnectOptions = Omit<RuntimeScopedChannelOptions, 'scope' | 'deviceId' | 'ticket'> & {
-    /**
-     * Device selected from `client.devices.*`. Passing the device object lets
-     * OpenRTC reuse its current ticket for native and ticket-gated routes.
-     */
-    device?: string | RuntimeDevice;
-    deviceId?: string | null;
-    ticket?: string;
-    /**
-     * Logical channel lifecycle scope. Most app channels should use the default
-     * `session`; pass a custom scope only when you intentionally manage peer
-     * lifecycle separately from the channel.
-     */
-    scope?: RuntimeScopedChannelOptions['scope'];
-};
-type OpenRTCDeviceSessionOptions = Omit<RuntimeManagedSessionOptions, 'platform'> & {
-    /**
-     * Runtime host for the managed user-device session. Normal apps can omit
-     * this: `OpenRTC(...)` defaults to `web`, and `OpenRTC.native(...)` defaults
-     * to `native`.
-     */
-    platform?: RuntimeManagedSessionOptions['platform'];
-};
-interface OpenRTCDeviceNamespace {
-    startSession(options?: OpenRTCDeviceSessionOptions): Promise<RuntimeManagedSession>;
-    stopSession(options?: {
-        preserveBackendSession?: boolean;
-    }): Promise<void>;
-    list(): Promise<RuntimeDevice[]>;
-    listWithStatus(): Promise<RuntimeDeviceStatusSnapshot[]>;
-    watch(callback: (devices: RuntimeDevice[]) => void): () => void;
-    watchWithStatus(callback: (devices: RuntimeDeviceStatusSnapshot[]) => void): () => void;
-    connect(device: string | RuntimeDevice, options?: RuntimeDeviceConnectOptions): Promise<ConnectDeviceResult>;
-    /**
-     * @deprecated Use `devices.connect()`. Retry and route recovery are owned by
-     * OpenRTC; legacy consumer-provided connection hooks are ignored.
-     */
-    connectWithRetry(device: string | RuntimeDevice, hooks: ConnectDeviceHooks, options: ConnectDeviceOptions): Promise<ConnectDeviceResult>;
-    disconnect(deviceId: string): Promise<void>;
-    update(deviceId: string, updates: {
-        deviceName?: string;
-        capabilities?: RuntimeDevice['capabilities'];
-        metadata?: string;
-    }): Promise<void>;
-    delete(deviceId: string): Promise<void>;
-    localId(): Promise<string | null>;
-    localInfo(): Promise<RuntimeLocalDeviceInfo | null>;
-    localProfile(options?: {
-        deviceName?: string;
-        localDeviceId?: string | null;
-        platform?: 'native' | 'web';
-        userId?: string | null;
-    }): Promise<RuntimeLocalDeviceProfile>;
-    updateLocalName(deviceName: string): Promise<RuntimeLocalDeviceInfo | null>;
-}
-interface OpenRTCPeerNamespace {
-    watch(callback: (peers: RuntimePeerState[]) => void): () => void;
-    watchLifecycle(callback: (peers: RuntimePeerState[]) => void): () => void;
-    get(id: string): RuntimePeerState | undefined;
-    listConnected(): RuntimePeerState[];
-    connect(options: RuntimePeerConnectOptions): Promise<Connection>;
-    disconnect(id: string, scope?: string): Promise<void>;
-    forceDisconnect(id: string): Promise<void>;
-    session(id: string): Promise<PeerSessionSnapshot | null>;
-    sessions(): Promise<PeerSessionSnapshot[]>;
-    waitConnected(id: string, timeoutMs?: number): Promise<PeerSessionSnapshot | null>;
-    readiness(id: string, timeoutMs?: number): Promise<RuntimePeerReadinessSnapshot>;
-    health(id: string): Promise<RuntimePeerHealth>;
-    identity(id: string): Promise<ResolvedPeerIdentity>;
-    addScope(id: string, scope?: string): RuntimePeerState | undefined;
-    releaseScope(id: string, scope?: string): RuntimePeerState | undefined;
-    scopes(id: string): string[];
-    refresh(): Promise<RuntimePeerState[]>;
-}
-interface OpenRTCChannelNamespace {
-    register(descriptor: RuntimeChannelDescriptor): void;
-    unregister(channelId: string): void;
-    list(): RuntimeChannelDescriptor[];
-    openBi(id: string, channelId: string, options?: Omit<RuntimePeerStreamOptions, 'channelId'>): Promise<{
-        connection: Connection;
-        readable: ReadableStream<Uint8Array>;
-        writable: WritableStream<Uint8Array>;
-    }>;
-    openUni(id: string, channelId: string, options?: Omit<RuntimePeerStreamOptions, 'channelId'>): Promise<{
-        connection: Connection;
-        writable: WritableStream<Uint8Array>;
-    }>;
-    onIncoming(callback: (stream: RuntimeIncomingStream) => boolean | void): () => void;
-    onIncomingChannel(channelId: string, callback: (stream: RuntimeIncomingStream & {
-        channel: NonNullable<RuntimeIncomingStream['channel']>;
-    }) => boolean | void): () => void;
-    connect(options: OpenRTCChannelConnectOptions): Promise<RuntimeScopedLogicalChannel>;
-    connectScoped(options: RuntimeScopedChannelOptions): Promise<RuntimeScopedLogicalChannel>;
-}
-interface OpenRTCRoomNamespace {
-    create(roomId?: string): Promise<string>;
-    join(roomId: string, options?: RuntimeJoinRoomOptions): Promise<Connection[]>;
-    leave(roomId: string): Promise<void>;
-    watch(roomId: string, callback: (members: RuntimeRoomMember[]) => void): () => void;
-    members(roomId: string): Promise<RuntimeRoomMember[]>;
-}
-interface OpenRTCTicketNamespace {
-    raw(): Promise<string>;
-    share(options?: {
-        maxConnections?: number;
-    }): Promise<string>;
-    grant(scope: GrantScope, options?: {
-        maxConnections?: number;
-    }): Promise<string>;
-    revoke(scope: GrantScope): Promise<string[]>;
-}
-interface OpenRTCDiagnosticsNamespace {
-    status(): Promise<{
-        runtime: 'tauri' | 'browser' | 'unknown';
-        wasmLoaded: boolean;
-        localNodeId?: string;
-        userId?: string;
-    }>;
-    policy(): RuntimePolicySnapshot;
-    capabilities(): RuntimeCapabilities;
-    capabilityProfile(): RuntimeCapabilityProfile;
-    connectionStates(): Promise<RuntimeConnectionStateSnapshot[]>;
-    onConnectionStateChange(callback: (state: RuntimeConnectionStateSnapshot) => void): Promise<() => void> | (() => void);
-    connections(): Connection[];
-    applicationReadyConnections(options?: RuntimeApplicationPayloadReadinessOptions): Connection[];
-    onConnection(callback: (connection: Connection) => void): () => void;
-    onDisconnection(callback: (connection: Connection) => void): () => void;
-    onConnectionEvent(callback: (event: RuntimeConnectionEvent) => void): () => void;
-    forceReconnectSnapshot(): void;
-    peerReconciliation(): Readonly<PeerReconciliationStats>;
-}
-interface OpenRTCAdvancedNamespace {
-    readonly runtime: RuntimeClient;
-    readonly assembly: PlutoRuntimeAssembly;
-    nodeId(): Promise<string>;
-    nodeIdFromTicket(ticket: string): Promise<string | null>;
-    endpointTicket(): Promise<string>;
-    connectRaw(target: {
-        ticket: string;
-        timeoutMs?: number;
-    }): Promise<RuntimeRawConnection>;
-    openBi(nodeId: string): Promise<{
-        readable: ReadableStream<Uint8Array>;
-        writable: WritableStream<Uint8Array>;
-    }>;
-    openUni(nodeId: string): Promise<WritableStream<Uint8Array>>;
-    isConnected(nodeId: string): Promise<boolean>;
-    disconnectNode(nodeId: string): Promise<void>;
-    setAutoConnectExcluded(deviceId: string, excluded: boolean): Promise<void>;
-    notifyNetworkChange(reason?: string): Promise<void>;
-}
 /**
- * OpenRTCClient extends RuntimeClient with auth helpers that were
- * previously only available on PlutoRuntimeAssembly.
+ * OpenRTC developer-facing browser entrypoint and compatibility native factory.
  *
- * This is the unified type returned by OpenRTC() and OpenRTC.native().
+ * Native-only applications should import `createNativeOpenRTC` from
+ * `openrtc/native` so their webview bundle does not carry the browser WASM
+ * runtime.
  */
-interface OpenRTCClient extends RuntimeClient {
-    readonly devices: OpenRTCDeviceNamespace;
-    readonly peers: OpenRTCPeerNamespace;
-    readonly channels: OpenRTCChannelNamespace;
-    readonly rooms: OpenRTCRoomNamespace;
-    readonly tickets: OpenRTCTicketNamespace;
-    readonly diagnostics: OpenRTCDiagnosticsNamespace;
-    readonly advanced: OpenRTCAdvancedNamespace;
-    /** @deprecated Use setAuth() instead */
-    setAuthContext(context: AuthContext | null): Promise<void>;
-    /** Set auth context for the runtime */
-    setAuth(context: AuthContext | null): Promise<void>;
-    /** Sync Pluto-hosted auth to the runtime */
-    syncPlutoAuth(options?: {
-        userId?: string | null;
-        forceRefresh?: boolean;
-    }): Promise<void>;
-    /** Bind Pluto auth host to auto-sync on token changes */
-    bindPlutoAuthHost(): () => void;
-    /** Sign in via Pluto SSO */
-    signIn(): Promise<void>;
-    /** Sign out and clear auth context */
-    signOut(): Promise<void>;
-    /**
-     * @deprecated Use `client.devices.startSession(...)` for the public
-     * user-device avenue lifecycle. This top-level method remains for
-     * RuntimeClient compatibility and advanced integrations.
-     */
-    startManagedSession(options: RuntimeManagedSessionOptions): Promise<RuntimeManagedSession>;
-    /**
-     * @deprecated Use `client.devices.stopSession(...)` for the public
-     * user-device avenue lifecycle.
-     */
-    stopManagedSession(options?: {
-        preserveBackendSession?: boolean;
-    }): Promise<void>;
-    /** @deprecated Use `client.rooms.create(...)`. */
-    createRoom(roomId?: string): Promise<string>;
-    /** @deprecated Use `client.rooms.join(...)`. */
-    joinRoom(roomId: string, options?: RuntimeJoinRoomOptions): Promise<Connection[]>;
-    /** @deprecated Use `client.rooms.leave(...)`. */
-    leaveRoom(roomId: string): Promise<void>;
-    /** @deprecated Use `client.rooms.watch(...)`. */
-    watchRoom(roomId: string, callback: (members: RuntimeRoomMember[]) => void): () => void;
-    /** @deprecated Use `client.rooms.members(...)`. */
-    getRoomMembers(roomId: string): Promise<RuntimeRoomMember[]>;
-    /** @deprecated Use `client.tickets.raw(...)`. */
-    getInvite(): Promise<string>;
-    /** @deprecated Use `client.tickets.raw(...)`. */
-    getTicket(): Promise<string>;
-    /** @deprecated Use `client.tickets.share(...)` or `client.tickets.grant(...)`. */
-    getTicketWithToken(scope: GrantScope, maxConnections?: number): Promise<string>;
-    /** @deprecated Use `client.tickets.revoke(...)`. */
-    revokeTokensByScope(scope: GrantScope): Promise<string[]>;
-    /** @deprecated Use `client.peers.connect(...)`. */
-    connectPeer(options: RuntimePeerConnectOptions): Promise<Connection>;
-    /** @deprecated Use `client.peers.connect(...)`. */
-    connectTo(options: RuntimePeerConnectOptions): Promise<Connection>;
-    /** @deprecated Use `client.peers.waitConnected(...)`. */
-    waitForConnectedPeer(id: string, timeoutMs?: number): Promise<PeerSessionSnapshot | null>;
-    /** @deprecated Use `client.channels.connect(...)`; use `client.channels.connectScoped(...)` only for custom lifecycle scopes. */
-    connectScopedChannel(options: RuntimeScopedChannelOptions): Promise<RuntimeScopedLogicalChannel>;
-    /** @deprecated Use `client.channels.openBi(...)`. */
-    openPeerBi(id: string, options?: RuntimePeerStreamOptions): Promise<{
-        connection: Connection;
-        readable: ReadableStream<Uint8Array>;
-        writable: WritableStream<Uint8Array>;
-    }>;
-    /** @deprecated Use `client.channels.openUni(...)`. */
-    openPeerUni(id: string, options?: RuntimePeerStreamOptions): Promise<{
-        connection: Connection;
-        writable: WritableStream<Uint8Array>;
-    }>;
-    /**
-     * Access to the underlying PlutoRuntimeAssembly for backward compatibility.
-     * @deprecated Access methods directly on the client instead.
-     */
-    readonly runtime: RuntimeClient;
-    /**
-     * Access to the underlying PlutoRuntimeAssembly for backward compatibility.
-     * @internal
-     */
-    readonly _assembly: PlutoRuntimeAssembly;
-}
+
 /**
  * Create an OpenRTC client for browser/WASM environments.
- *
- * @example
- * ```typescript
- * import { OpenRTC } from 'openrtc';
- * const client = OpenRTC({
- *   apiKey: 'pk_live_...',
- *   authMode: 'anonymous',
- * });
- * await client.connect();
- * ```
  */
 declare function OpenRTC(options: RuntimeClientOptions): OpenRTCClient;
 declare namespace OpenRTC {
@@ -309,55 +67,7 @@ declare function generateEphemeralKeyAgreement(randomBytes?: (byteLength: number
 declare function deriveApplicationCryptoKey(localSecretKey: Uint8Array, remotePublicKey: Uint8Array, localNodeId: string, remoteNodeId: string): Uint8Array;
 declare function encodeApplicationKeyAgreementPayload(publicKey: Uint8Array): ApplicationKeyAgreementPayload;
 
-type MintSpaceTokenRequest = {
-    spaceKey: string;
-    memberId?: string;
-    ttl?: number;
-    sandboxAppId?: string;
-};
-type MintSpaceTokenResponse = {
-    token: string;
-    expiresAt: number;
-    tokenLifetimeSeconds: number;
-    namespaceId: string;
-    spaceAppTag: string;
-};
-/**
- * Mint a namespace-scoped Firebase custom token from your backend using the
- * OpenRTC `POST /v1/spaces/tokens` endpoint. Never call this from browser code
- * with a secret key — proxy through your server.
- */
-type EnableSpaceAuthResponse = {
-    success: true;
-    space: {
-        namespaceId: string;
-        requireScopedAuth: boolean;
-        status: 'active' | 'revoked';
-    };
-};
-/**
- * Opt a provisioned space into scoped-auth mode (required for all spaces).
- * Call from your backend with sk_live_... only.
- */
-declare function enableSpaceAuth(endpointUrl: string, secretKey: string, namespaceId: string): Promise<EnableSpaceAuthResponse>;
-declare function mintSpaceToken(endpointUrl: string, secretKey: string, request: MintSpaceTokenRequest): Promise<MintSpaceTokenResponse>;
-/**
- * Browser-safe space auth for static sites. Calls the rate-limited
- * `v1SpacePublicTokens` endpoint (pk_live_ + spaceKey only).
- */
-declare function createPublicSpaceTokenProvider(options: {
-    apiKey: string;
-    space?: string;
-    spaceKey?: string;
-    endpointUrl?: string;
-    memberIdStorageKey?: string;
-    sandboxAppId?: string;
-}): SpaceTokenProvider;
-declare function sandboxSpaceKey(spaceKey: string, sandboxAppId?: string): string;
-declare const spaceToken: typeof createPublicSpaceTokenProvider;
-declare const createSpaceTokenProvider: typeof createPublicSpaceTokenProvider;
-
 type UpgradeState = 'none' | 'upgrading' | 'upgraded' | 'failed';
 type OutboundMessage = string | object | ArrayBuffer | Uint8Array;
 
-export { ApplicationCryptoStreamTools, type ApplicationKeyAgreementPayload, ApplicationPayloadCrypto, type EnableSpaceAuthResponse, GrantScope, KEY_AGREEMENT_ALGORITHM, KEY_AGREEMENT_PUBLIC_KEY_BYTES, type MintSpaceTokenRequest, type MintSpaceTokenResponse, OpenRTC, type OpenRTCChannelConnectOptions, type OpenRTCClient, type OpenRTCDeviceNamespace, type OpenRTCDeviceSessionOptions, RuntimeClientOptions as OpenRTCOptions, type OpenRTCRoomNamespace, type OpenRTCTicketNamespace, type OutboundMessage, ProtocolCapability, ProtocolCapabilityMap, ProtocolName, RuntimeApplicationPayloadReadinessOptions, RuntimeCapabilities, RuntimeChannelDescriptor, RuntimeClientOptions, RuntimeConnectionEvent, RuntimeConnectionStateSnapshot, RuntimeDevice, RuntimeDeviceConnectOptions, RuntimeDeviceStatusSnapshot, RuntimeIncomingStream, RuntimeJoinRoomOptions, RuntimeLocalDeviceInfo, RuntimeLocalDeviceProfile, RuntimeManagedSession, RuntimeManagedSessionOptions, RuntimePeerConnectOptions, RuntimePeerHealth, RuntimePeerReadinessSnapshot, RuntimePeerState, RuntimePeerStreamOptions, RuntimePolicySnapshot, RuntimeRawConnection, RuntimeRoomMember, RuntimeScopedChannelOptions, RuntimeScopedLogicalChannel, SpaceTokenProvider, type UpgradeState, createApplicationCryptoStreamTools, createPublicSpaceTokenProvider, createSharedSecretApplicationCrypto, createSpaceTokenProvider, deriveApplicationCryptoKey, enableSpaceAuth, encodeApplicationKeyAgreementPayload, generateEphemeralKeyAgreement, getPreferredProtocolOrder, isApplicationEncryptedPayload, mintSpaceToken, sandboxSpaceKey, spaceToken };
+export { ApplicationCryptoStreamTools, type ApplicationKeyAgreementPayload, ApplicationPayloadCrypto, KEY_AGREEMENT_ALGORITHM, KEY_AGREEMENT_PUBLIC_KEY_BYTES, OpenRTC, OpenRTCClient, RuntimeClientOptions as OpenRTCOptions, type OutboundMessage, ProtocolCapability, ProtocolCapabilityMap, ProtocolName, RuntimeClientOptions, type UpgradeState, createApplicationCryptoStreamTools, createSharedSecretApplicationCrypto, deriveApplicationCryptoKey, encodeApplicationKeyAgreementPayload, generateEphemeralKeyAgreement, getPreferredProtocolOrder, isApplicationEncryptedPayload };

package/dist/index.js

@@ -1,2 +1 @@
-import {z,A}from'./chunk-NCRP5ODV.js';export{c as KEY_AGREEMENT_ALGORITHM,b as KEY_AGREEMENT_PUBLIC_KEY_BYTES,g as ScopedSession,v as createRuntimeJsonFrameDecoder,r as createRuntimeU32BEFrameDecoder,t as decodeRuntimeJsonPayload,e as deriveApplicationCryptoKey,f as encodeApplicationKeyAgreementPayload,u as encodeRuntimeJsonFrame,s as encodeRuntimeJsonPayload,q as encodeRuntimeU32BEFrame,d as generateEphemeralKeyAgreement,a as getPreferredProtocolOrder}from'./chunk-NCRP5ODV.js';export{a as isRuntimeDeviceActive,c as isRuntimeDeviceConnectable,b as isRuntimeDeviceRoutable}from'./chunk-CK6WQV7J.js';import'./chunk-BGQX25BO.js';import {g}from'./chunk-L6OUJ6YN.js';export{w as OPENRTC_RUNTIME_POLICY,n as createApplicationCryptoStreamTools,m as createSharedSecretApplicationCrypto,x as getRuntimePolicy,l as isApplicationEncryptedPayload}from'./chunk-MESPJTUA.js';import {p}from'./chunk-34LATQZZ.js';export{a as TRANSPORT_LABELS,d as isDirectIrohTransportLabel,h as isIndependentTransportLabel,c as isIrohBaseTransportLabel,e as isOptionalTransportLabel,f as isWebRtcTransportLabel,b as normalizeTransportLabel}from'./chunk-QT2ASNI3.js';export{a as ROUTE_DESCRIPTORS,e as getRouteDescriptor,f as listRouteDescriptors}from'./chunk-C7YN5MSV.js';function O(t){let i=p({...t});if("auth"in t&&!t.authMode){let n=t.auth;i.authMode=n==="none"?"anonymous":n;}if("identity"in t){let n=t.identity,r=n==="temporary"?"ephemeral":n;!t.deviceIdPersistence&&!t.nodeIdPersistence&&(i.deviceIdPersistence=r),!t.endpointIdPersistence&&!t.nodeIdPersistence&&(i.endpointIdPersistence=r);}return "namespace"in t&&!t.storagePrefix&&(i.storagePrefix=t.namespace),"privacy"in t&&t.strictMode===void 0&&(i.strictMode=!!t.privacy),i}function I(t,i){let n=t.runtime,r=Object.create(n),s=async e=>{if(typeof e!="string")return e;let a=(await n.listDevices()).find(d=>d.deviceId===e);if(!a)throw new Error(`OpenRTC device '${e}' is not currently discoverable.`);return a},c=async e=>({...e,localDeviceId:e?.localDeviceId??await n.getLocalDeviceId()??""}),p=async e=>{let{device:o,scope:a,...d}=e,g=d.deviceId??(typeof o=="string"?o:o?.deviceId)??null,P=d.ticket??(typeof o=="string"?void 0:o?.ticket);g&&!P&&(P=(await s(g).catch(()=>null))?.ticket);let C={...d,scope:a??"session"};return g&&(C.deviceId=g),P&&(C.ticket=P),C},l={list:()=>n.listDevices(),startSession:(e={})=>n.startManagedSession({...e,platform:e.platform??i}),stopSession:e=>n.stopManagedSession(e),listWithStatus:()=>n.listDevicesWithStatus(),watch:e=>n.watchDevices(e),watchWithStatus:e=>n.watchDevicesWithStatus(e),connect:async(e,o)=>n.connectDevice(await s(e),await c(o)),connectWithRetry:async(e,o,a)=>n.connectDeviceWithRetry(await s(e),o,a),disconnect:e=>n.disconnectDevice(e),update:(e,o)=>n.updateDevice(e,o),delete:e=>n.deleteDevice(e),localId:()=>n.getLocalDeviceId(),localInfo:()=>n.getLocalDeviceInfo(),localProfile:e=>n.getLocalDeviceProfile(e),updateLocalName:e=>n.updateLocalDeviceName(e)},u={watch:e=>n.watchPeerStates(e),watchLifecycle:e=>n.watchPeerLifecycle(e),get:e=>n.getPeerState(e),listConnected:()=>n.listConnectedPeers(),connect:e=>n.connectPeer(e),disconnect:(e,o)=>n.disconnectPeer(e,o),forceDisconnect:e=>n.forceDisconnectPeer(e),session:e=>n.getPeerSession(e),sessions:()=>n.listPeerSessions(),waitConnected:(e,o)=>n.waitForConnectedPeer(e,o),readiness:(e,o)=>n.getPeerReadiness(e,o),health:e=>n.getPeerHealth(e),identity:e=>n.resolvePeerIdentity(e),addScope:(e,o)=>n.addPeerScope(e,o),releaseScope:(e,o)=>n.releasePeerScope(e,o),scopes:e=>n.getPeerScopes(e),refresh:()=>n.refreshPeerSnapshot()},m={register:e=>n.registerChannel(e),unregister:e=>n.unregisterChannel(e),list:()=>n.listChannels(),openBi:(e,o,a)=>n.openPeerBi(e,{...a,channelId:o}),openUni:(e,o,a)=>n.openPeerUni(e,{...a,channelId:o}),onIncoming:e=>n.onIncomingStream(e),onIncomingChannel:(e,o)=>n.onIncomingChannelStream(e,a=>{if(a.channel)return o(a)}),connect:async e=>n.connectScopedChannel(await p(e)),connectScoped:e=>n.connectScopedChannel(e)},R={create:e=>n.createRoom(e),join:(e,o)=>n.joinRoom(e,o),leave:e=>n.leaveRoom(e),watch:(e,o)=>n.watchRoom(e,o),members:e=>n.getRoomMembers(e)},y={raw:()=>n.getInvite(),share:e=>n.getTicketWithToken("share",e?.maxConnections??1),grant:(e,o)=>n.getTicketWithToken(e,o?.maxConnections??0),revoke:e=>n.revokeTokensByScope(e)},A={status:()=>n.getRuntimeStatus(),policy:()=>n.getRuntimePolicy(),capabilities:()=>n.getRuntimeCapabilities(),capabilityProfile:()=>n.getCapabilityProfile(),connectionStates:()=>n.getConnectionStates(),onConnectionStateChange:e=>n.onConnectionStateChange(e),connections:()=>n.getConnections(),applicationReadyConnections:e=>n.getApplicationReadyConnections(e),onConnection:e=>n.onConnection(e),onDisconnection:e=>n.onDisconnection(e),onConnectionEvent:e=>n.onConnectionEvent(e),forceReconnectSnapshot:()=>n.forceReconnectSnapshot(),peerReconciliation:()=>n.getPeerReconciliationStats()},w={runtime:n,assembly:t,nodeId:()=>n.getNodeId(),nodeIdFromTicket:e=>n.getNodeIdFromTicket(e),endpointTicket:()=>n.getEndpointTicket(),connectRaw:e=>n.connectRaw(e),openBi:e=>n.openBi(e),openUni:e=>n.openUni(e),isConnected:e=>n.isConnected(e),disconnectNode:e=>n.disconnectNode(e),setAutoConnectExcluded:(e,o)=>n.setAutoConnectExcluded(e,o),notifyNetworkChange:e=>n.notifyNetworkChange(e)};return Object.defineProperties(r,{devices:{get:()=>l,enumerable:true},peers:{get:()=>u,enumerable:true},channels:{get:()=>m,enumerable:true},rooms:{get:()=>R,enumerable:true},tickets:{get:()=>y,enumerable:true},diagnostics:{get:()=>A,enumerable:true},advanced:{get:()=>w,enumerable:true},setAuth:{value:e=>t.setAuthContext(e),enumerable:true,writable:true,configurable:true},setAuthContext:{value:e=>t.setAuthContext(e),enumerable:true,writable:true,configurable:true},syncPlutoAuth:{value:e=>t.syncPlutoAuth(e),enumerable:true,writable:true,configurable:true},bindPlutoAuthHost:{value:()=>t.bindPlutoAuthHost(),enumerable:true,writable:true,configurable:true},signIn:{value:()=>t.signInWithPluto(),enumerable:true,writable:true,configurable:true},signOut:{value:()=>t.signOut(),enumerable:true,writable:true,configurable:true},runtime:{get:()=>n,enumerable:false},_assembly:{get:()=>t,enumerable:false}}),r}function T(t){let i=O(t),n=z(i);return I(n,"web")}T.native=function(t,i){let n=O(t),r=i??g(),s=A(n,r);return I(s,"native")};var ae="https://api.openrtc.app";async function ce(t,i,n){let r=t.replace(/\/$/,""),s=await fetch(`${r}/v1/spaces/${encodeURIComponent(n)}/scoped-auth`,{method:"POST",headers:{Authorization:`Bearer ${i}`,"Content-Type":"application/json"},body:"{}"}),c=await s.json().catch(()=>({}));if(!s.ok){let p=typeof c?.error=="string"?c.error:`enableSpaceAuth failed (${s.status})`;throw new Error(p)}return c}async function pe(t,i,n){let r=await fetch(t,{method:"POST",headers:{Authorization:`Bearer ${i}`,"Content-Type":"application/json"},body:JSON.stringify(n)}),s=await r.json().catch(()=>({}));if(!r.ok){let c=typeof s?.error=="string"?s.error:`mintSpaceToken failed (${r.status})`;throw new Error(c)}if(typeof s?.token!="string"||!s.token.trim())throw new Error("mintSpaceToken response missing token");return s}function S(t){let i=t.apiKey.trim(),n=(t.spaceKey??t.space??"").trim(),r=k(t.sandboxAppId),s=(t.endpointUrl??ae).replace(/\/$/,""),c=t.memberIdStorageKey??`openrtc:space-member:${n}${r?`:sandbox:${r}`:""}`;return async()=>{if(!i||!n)throw new Error("spaceToken requires apiKey and space");let p=null;typeof sessionStorage<"u"?(p=sessionStorage.getItem(c),p||(p=globalThis.crypto?.randomUUID?.()??`member-${Date.now()}`,sessionStorage.setItem(c,p))):p=`member-${Date.now()}`;let l=await fetch(`${s}/v1SpacePublicTokens`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({apiKey:i,spaceKey:n,memberId:p,...r?{sandboxAppId:r}:{}})}),{text:u,payload:m}=await le(l);if(!l.ok){let y=typeof m?.error=="string"?m.error:u.trim()?u.trim().slice(0,240):`public space token mint failed (${l.status})`;throw new Error(y)}let R=typeof m?.token=="string"?m.token.trim():"";if(!R)throw new Error("public space token response missing token");return {customToken:R}}}function me(t){if(!t.trim())return {};try{let i=JSON.parse(t);return i&&typeof i=="object"?i:{}}catch{return {}}}async function le(t){let i=t.text;if(typeof i=="function"){let r=await i.call(t).catch(()=>"");return {text:r,payload:me(r)}}let n=await t.json().catch(()=>({}));return {text:JSON.stringify(n),payload:n&&typeof n=="object"?n:{}}}function k(t){let i=t?.trim().toLowerCase()??"";if(!i)return "";if(!/^[a-z0-9][a-z0-9-]{0,47}$/.test(i))throw new Error("sandboxAppId must be 1-48 lowercase letters, numbers, or dashes.");return i}function de(t,i){let n=t.trim(),r=k(i);return r?`${n}::sandbox::${r}`:n}var ue=S,Re=S;
-export{T as OpenRTC,S as createPublicSpaceTokenProvider,Re as createSpaceTokenProvider,ce as enableSpaceAuth,pe as mintSpaceToken,de as sandboxSpaceKey,ue as spaceToken};
+import {a,b}from'./chunk-SJ5BFL6W.js';export{e as createPublicSpaceTokenProvider,h as createSpaceTokenProvider,c as enableSpaceAuth,d as mintSpaceToken,f as sandboxSpaceKey,g as spaceToken}from'./chunk-SJ5BFL6W.js';import {a as a$1,b as b$1}from'./chunk-4AXAWVC6.js';export{d as KEY_AGREEMENT_ALGORITHM,c as KEY_AGREEMENT_PUBLIC_KEY_BYTES,h as ScopedSession,w as createRuntimeJsonFrameDecoder,s as createRuntimeU32BEFrameDecoder,u as decodeRuntimeJsonPayload,f as deriveApplicationCryptoKey,g as encodeApplicationKeyAgreementPayload,v as encodeRuntimeJsonFrame,t as encodeRuntimeJsonPayload,r as encodeRuntimeU32BEFrame,e as generateEphemeralKeyAgreement,b as getPreferredProtocolOrder}from'./chunk-7352ZIXN.js';export{a as isRuntimeDeviceActive,c as isRuntimeDeviceConnectable,b as isRuntimeDeviceRoutable}from'./chunk-CK6WQV7J.js';import'./chunk-MNI6JGR2.js';import {g}from'./chunk-DI5IPRPM.js';export{w as OPENRTC_RUNTIME_POLICY,n as createApplicationCryptoStreamTools,m as createSharedSecretApplicationCrypto,x as getRuntimePolicy,l as isApplicationEncryptedPayload}from'./chunk-YTUWXCRO.js';export{a as TRANSPORT_LABELS,d as isDirectIrohTransportLabel,h as isIndependentTransportLabel,c as isIrohBaseTransportLabel,e as isOptionalTransportLabel,f as isWebRtcTransportLabel,b as normalizeTransportLabel}from'./chunk-QT2ASNI3.js';import'./chunk-HVTYSEU7.js';export{a as ROUTE_DESCRIPTORS,e as getRouteDescriptor,f as listRouteDescriptors}from'./chunk-C7YN5MSV.js';function s(e){let t=a(e),o=a$1(t);return b(o,"web")}s.native=function(e,t){let o=a(e),c=t??g(),m=b$1(o,c);return b(m,"native")};export{s as OpenRTC};

package/dist/ipc-CflAVodw.d.ts

@@ -0,0 +1,11 @@
+type PlutoIpcUnlisten = () => void | Promise<void>;
+interface PlutoIpcBridge {
+    invoke<T = unknown>(command: string, args?: Record<string, unknown>): Promise<T>;
+    listen<T = unknown>(event: string, handler: (payload: T) => void): Promise<PlutoIpcUnlisten>;
+    isAvailable?(): boolean | Promise<boolean>;
+}
+type NativeIpcFailureKind = 'command-unavailable' | 'runtime-unavailable' | 'timeout' | 'unknown';
+declare function classifyNativeIpcFailure(error: unknown): NativeIpcFailureKind;
+declare function isNativeIpcCommandUnavailable(error: unknown): boolean;
+
+export { type NativeIpcFailureKind as N, type PlutoIpcBridge as P, type PlutoIpcUnlisten as a, classifyNativeIpcFailure as c, isNativeIpcCommandUnavailable as i };

package/dist/native.d.ts

@@ -0,0 +1,20 @@
+import { R as RuntimeClientOptions } from './types-N9s66nF8.js';
+import { P as PlutoIpcBridge } from './ipc-CflAVodw.js';
+import { O as OpenRTCClient } from './spaceTokens-3sbs1mUF.js';
+export { E as EnableSpaceAuthResponse, M as MintSpaceTokenRequest, a as MintSpaceTokenResponse, b as OpenRTCChannelConnectOptions, c as OpenRTCDeviceNamespace, d as OpenRTCDeviceSessionOptions, e as OpenRTCRoomNamespace, f as OpenRTCTicketNamespace, g as createPublicSpaceTokenProvider, h as createSpaceTokenProvider, i as enableSpaceAuth, m as mintSpaceToken, s as sandboxSpaceKey, j as spaceToken } from './spaceTokens-3sbs1mUF.js';
+export { S as SpaceAuthMode, a as SpaceTokenProvider } from './types-ZDsZknDI.js';
+import './IEngineBridge-C7OT2CRv.js';
+import './assembly-C2G0P2L5.js';
+import './capabilities-C4Dqs_pB.js';
+
+/**
+ * Native-only OpenRTC entrypoint.
+ *
+ * This entry deliberately imports only the IPC runtime. It is the preferred
+ * entry for Tauri webviews because it excludes the browser WASM adapter and
+ * binary from the application bundle.
+ */
+
+declare function createNativeOpenRTC(options: RuntimeClientOptions, bridge: PlutoIpcBridge): OpenRTCClient;
+
+export { OpenRTCClient, createNativeOpenRTC };

package/dist/native.js

@@ -0,0 +1 @@
+import {a as a$1,b}from'./chunk-SJ5BFL6W.js';export{e as createPublicSpaceTokenProvider,h as createSpaceTokenProvider,c as enableSpaceAuth,d as mintSpaceToken,f as sandboxSpaceKey,g as spaceToken}from'./chunk-SJ5BFL6W.js';import {A as A$1}from'./chunk-7352ZIXN.js';import {h}from'./chunk-DI5IPRPM.js';import'./chunk-YTUWXCRO.js';import'./chunk-QT2ASNI3.js';import {s}from'./chunk-HVTYSEU7.js';import'./chunk-C7YN5MSV.js';function a(t,p){let e=s(t);return A$1(e,new h({...e,bridge:p}))}function A(t,p){let e=a(a$1(t),p);return b(e,"native")}export{A as createNativeOpenRTC};

package/dist/runtime/WasmRuntimeAdapter.d.ts

@@ -1,6 +1,7 @@
-import { D as DelegatingRuntimeAdapter, W as WasmBridgeOptions } from '../DelegatingRuntimeAdapter-D2_dgabz.js';
-import '../types-ByZyADCn.js';
+import { D as DelegatingRuntimeAdapter, W as WasmBridgeOptions } from '../DelegatingRuntimeAdapter-lFDUNBy9.js';
+import '../types-ZDsZknDI.js';
 import '../IEngineBridge-C7OT2CRv.js';
+import '../capabilities-C4Dqs_pB.js';
 
 declare class WasmRuntimeAdapter extends DelegatingRuntimeAdapter {
     constructor(options: WasmBridgeOptions);

package/dist/runtime/WasmRuntimeAdapter.js

@@ -1 +1 @@
-export{a as WasmRuntimeAdapter}from'../chunk-BGQX25BO.js';import'../chunk-MESPJTUA.js';import'../chunk-34LATQZZ.js';import'../chunk-QT2ASNI3.js';import'../chunk-C7YN5MSV.js';
+export{a as WasmRuntimeAdapter}from'../chunk-MNI6JGR2.js';import'../chunk-YTUWXCRO.js';import'../chunk-QT2ASNI3.js';import'../chunk-HVTYSEU7.js';import'../chunk-C7YN5MSV.js';

package/dist/runtime/device-status.d.ts

@@ -1,3 +1,38 @@
-export { a2 as RuntimeDeviceActiveOptions, $ as isRuntimeDeviceActive, a0 as isRuntimeDeviceConnectable, a1 as isRuntimeDeviceRoutable } from '../device-status-CR27Ak7c.js';
+import { c as RuntimeDevice, d as RuntimeDeviceStatusSnapshot } from '../types-N9s66nF8.js';
 import '../IEngineBridge-C7OT2CRv.js';
-import '../types-ByZyADCn.js';
+import '../types-ZDsZknDI.js';
+
+interface RuntimeDeviceActiveOptions {
+    now?: number;
+    /**
+     * Optional local freshness window for durable roster rows. Leave undefined
+     * when the caller only wants to honor explicit online/expiresAt state.
+     */
+    staleAfterMs?: number;
+}
+type RuntimeDeviceActivityStatus = Pick<Partial<RuntimeDevice>, 'online' | 'lastSeenAt' | 'updatedAt' | 'createdAt' | 'expiresAt'>;
+type RuntimeDeviceRouteStatus = Pick<Partial<RuntimeDeviceStatusSnapshot>, 'settledReady' | 'readinessState' | 'connectionStatus'>;
+type RuntimeDevicePresenceStatus = Pick<RuntimeDevice, 'online' | 'ticket'> & Pick<Partial<RuntimeDeviceStatusSnapshot>, 'connectable' | 'presenceStatus' | 'online' | 'ticket'>;
+/**
+ * True when a runtime device row is currently live enough to display or
+ * consider for app-level routing. This is deliberately separate from
+ * `isRuntimeDeviceConnectable`: a peer can be active/present before it has a
+ * usable ticket, and a stale durable row should not keep app UIs alive.
+ */
+declare function isRuntimeDeviceActive(device: RuntimeDeviceActivityStatus, options?: RuntimeDeviceActiveOptions): boolean;
+/**
+ * True once OpenRTC has a routable peer projection for normal app payloads.
+ *
+ * This intentionally does not inspect discovery metadata or device
+ * capabilities. Those fields describe the remote endpoint roster entry; they
+ * are not proof that an application-level protocol has exchanged its own
+ * ready/capability message over the mesh.
+ */
+declare function isRuntimeDeviceRoutable(device: RuntimeDeviceRouteStatus): boolean;
+/**
+ * True when the discovery row currently has enough fresh presence to attempt
+ * a dial. This is a discovery gate, not a connected/readiness gate.
+ */
+declare function isRuntimeDeviceConnectable(device: RuntimeDevicePresenceStatus): boolean;
+
+export { type RuntimeDeviceActiveOptions, isRuntimeDeviceActive, isRuntimeDeviceConnectable, isRuntimeDeviceRoutable };

package/dist/runtime/index.d.ts

@@ -1,16 +1,21 @@
-import { P as PeerReconciliationStats } from '../framing-rPdckqn5.js';
-export { O as OPENRTC_RUNTIME_POLICY, b as PlutoRuntimeAssembly, R as RuntimeClient, n as RuntimeFactoryOptions, o as RuntimeJsonFrameDecoderOptions, c as RuntimeJsonFrameHandler, a as RuntimePolicySnapshot, d as RuntimeU32BEFrameHandler, D as ScopedConnectionActorError, p as ScopedConnectionActorErrorKind, q as ScopedConnectionActorHandle, r as ScopedConnectionActorHandleOptions, s as ScopedConnectionActorRegistry, t as ScopedConnectionActorState, u as ScopedConnectionClose, v as ScopedConnectionDial, w as ScopedConnectionKey, x as ScopedLogicalChannelHandle, y as ScopedPreferredTransport, z as concatRuntimeBytes, A as createIpcClient, g as createRuntimeJsonFrameDecoder, h as createRuntimeU32BEFrameDecoder, B as createWasmClient, i as decodeRuntimeJsonPayload, j as encodeRuntimeJsonFrame, k as encodeRuntimeJsonPayload, l as encodeRuntimeU32BEFrame, m as getRuntimePolicy, C as readRuntimeU32BE, E as scopedConnectionKey, F as scopedConnectionKeyToString } from '../framing-rPdckqn5.js';
+import { e as RuntimeFactoryOptions, b as PlutoRuntimeAssembly, P as PeerReconciliationStats } from '../assembly-C2G0P2L5.js';
+export { O as OPENRTC_RUNTIME_POLICY, R as RuntimeClient, a as RuntimePolicySnapshot, D as ScopedConnectionActorError, f as ScopedConnectionActorErrorKind, h as ScopedConnectionActorHandle, i as ScopedConnectionActorHandleOptions, j as ScopedConnectionActorRegistry, k as ScopedConnectionActorState, l as ScopedConnectionClose, m as ScopedConnectionDial, n as ScopedConnectionKey, o as ScopedLogicalChannelHandle, p as ScopedPreferredTransport, g as getRuntimePolicy, q as scopedConnectionKey, r as scopedConnectionKeyToString } from '../assembly-C2G0P2L5.js';
 import * as Draft14 from '@moq/net';
-import { U as SignalingOptions, I as ISignalingBackend, R as RuntimeIdentity, d as SignalingEnvelope, f as SignalingSession, a as Device, k as BackendConnectionState, u as AppLimits, G as GrantScope, V as JoinRoomOptions, W as RoomMember, X as IncomingStreamChannelMetadata, s as ApplicationCryptoStreamTools, Y as RoomCreationMode, C as ClientOptions, r as ApplicationPayloadCrypto, D as DiscoveryMode, q as ProtocolCapabilityMap, Z as ScanningLoopOptions, _ as ScanningLoopHandle, $ as RuntimeBootstrapOptions, a0 as RuntimeBootstrapResult, w as ApplicationPayloadReadinessOptions, a1 as ManagedApplicationRouteOptions, a2 as PeerState, a3 as PeerScope, a4 as PeerHealth, a5 as ChannelDescriptor, a6 as JoinRequest, i as NativeConnectParams, j as NativeConnectResult } from '../types-ByZyADCn.js';
-import { C as Connection, K as RuntimeConnectionTarget, v as RuntimeRawConnection } from '../device-status-CR27Ak7c.js';
-export { w as ChannelDescriptor, x as ConnectionEvent, y as ConnectionTarget, D as DeviceProfile, z as IncomingStream, P as PeerConnectOptions, A as PeerReadiness, B as PeerStreamOptions, E as PresenceLoopOptions, F as RawConnection, t as RuntimeApplicationPayloadReadinessOptions, G as RuntimeAuthContext, H as RuntimeAuthIdentity, J as RuntimeAutoConnectPolicy, l as RuntimeChannelDescriptor, R as RuntimeClientOptions, u as RuntimeConnectionEvent, s as RuntimeConnectionStateSnapshot, c as RuntimeDevice, a2 as RuntimeDeviceActiveOptions, e as RuntimeDeviceConnectOptions, L as RuntimeDevicePresenceStatus, M as RuntimeDeviceStatus, d as RuntimeDeviceStatusSnapshot, n as RuntimeIncomingStream, q as RuntimeJoinRoomOptions, f as RuntimeLocalDeviceInfo, g as RuntimeLocalDeviceProfile, N as RuntimeLogicalChannelFraming, b as RuntimeManagedSession, O as RuntimeManagedSessionKind, a as RuntimeManagedSessionOptions, Q as RuntimeManagedSessionPlatform, i as RuntimePeerConnectOptions, k as RuntimePeerHealth, S as RuntimePeerLifecycleStatus, j as RuntimePeerReadinessSnapshot, T as RuntimePeerScope, U as RuntimePeerSessionSnapshot, h as RuntimePeerState, m as RuntimePeerStreamOptions, V as RuntimePresenceLoopOptions, W as RuntimePresencePolicy, r as RuntimeRoomMember, o as RuntimeScopedChannelOptions, p as RuntimeScopedLogicalChannel, X as RuntimeSession, Y as RuntimeUiConnectionStatus, Z as ScopedChannelOptions, _ as ScopedLogicalChannel, a3 as Session, a4 as SessionOptions, $ as isRuntimeDeviceActive, a0 as isRuntimeDeviceConnectable, a1 as isRuntimeDeviceRoutable } from '../device-status-CR27Ak7c.js';
+import { a3 as SignalingOptions, I as ISignalingBackend, e as RuntimeIdentity, h as SignalingEnvelope, j as SignalingSession, f as Device, o as BackendConnectionState, X as AppLimits, G as GrantScope, J as JoinRoomOptions, H as RoomMember, x as IncomingStreamChannelMetadata, W as ApplicationCryptoStreamTools, a4 as RoomCreationMode, p as ClientOptions, r as ApplicationPayloadCrypto, D as DiscoveryMode, V as ProtocolCapabilityMap, a5 as ScanningLoopOptions, a6 as ScanningLoopHandle, a7 as RuntimeBootstrapOptions, a8 as RuntimeBootstrapResult, s as ApplicationPayloadReadinessOptions, a9 as ManagedApplicationRouteOptions, z as PeerState, K as PeerScope, F as PeerHealth, w as ChannelDescriptor, aa as JoinRequest, m as NativeConnectParams, n as NativeConnectResult } from '../types-ZDsZknDI.js';
+import { C as Connection, K as RuntimeConnectionTarget, v as RuntimeRawConnection } from '../types-N9s66nF8.js';
+export { w as ChannelDescriptor, x as ConnectionEvent, y as ConnectionTarget, D as DeviceProfile, z as IncomingStream, P as PeerConnectOptions, A as PeerReadiness, B as PeerStreamOptions, E as PresenceLoopOptions, F as RawConnection, t as RuntimeApplicationPayloadReadinessOptions, G as RuntimeAuthContext, H as RuntimeAuthIdentity, J as RuntimeAutoConnectPolicy, l as RuntimeChannelDescriptor, R as RuntimeClientOptions, u as RuntimeConnectionEvent, s as RuntimeConnectionStateSnapshot, c as RuntimeDevice, e as RuntimeDeviceConnectOptions, L as RuntimeDevicePresenceStatus, M as RuntimeDeviceStatus, d as RuntimeDeviceStatusSnapshot, n as RuntimeIncomingStream, q as RuntimeJoinRoomOptions, f as RuntimeLocalDeviceInfo, g as RuntimeLocalDeviceProfile, N as RuntimeLogicalChannelFraming, b as RuntimeManagedSession, O as RuntimeManagedSessionKind, a as RuntimeManagedSessionOptions, Q as RuntimeManagedSessionPlatform, i as RuntimePeerConnectOptions, k as RuntimePeerHealth, S as RuntimePeerLifecycleStatus, j as RuntimePeerReadinessSnapshot, T as RuntimePeerScope, U as RuntimePeerSessionSnapshot, h as RuntimePeerState, m as RuntimePeerStreamOptions, V as RuntimePresenceLoopOptions, W as RuntimePresencePolicy, r as RuntimeRoomMember, o as RuntimeScopedChannelOptions, p as RuntimeScopedLogicalChannel, X as RuntimeSession, Y as RuntimeUiConnectionStatus, Z as ScopedChannelOptions, _ as ScopedLogicalChannel, $ as Session, a0 as SessionOptions } from '../types-N9s66nF8.js';
 import { FirebaseApp } from 'firebase/app';
-import { R as RuntimeCapabilities } from '../DelegatingRuntimeAdapter-D2_dgabz.js';
-export { B as BROWSER_WASM_RUNTIME_CAPABILITIES, c as BrowserRuntimeCapabilityHost, N as NATIVE_IPC_RUNTIME_CAPABILITIES, d as NativeRuntimeStatusSnapshot, e as NativeRuntimeTransportFeatureStatus, b as RuntimeAdapterKind, a as RuntimeCapabilityProfile, f as cloneRuntimeCapabilities, r as runtimeCapabilitiesForBrowserHost, g as runtimeCapabilitiesFromNativeStatus, h as runtimeCapabilityProfile } from '../DelegatingRuntimeAdapter-D2_dgabz.js';
-export { I as IpcRuntimeAdapter, a as IpcRuntimeAdapterOptions, P as NativeBridge, b as NativeIpcFailureKind, P as PlutoIpcBridge, c as PlutoIpcUnlisten, d as classifyNativeIpcFailure, i as isNativeIpcCommandUnavailable } from '../IpcRuntimeAdapter-B8rkqNrq.js';
-export { WasmRuntimeAdapter } from './WasmRuntimeAdapter.js';
-export { TauriRuntimeAdapter, TauriRuntimeAdapterOptions, createTauriIpcBridge } from './tauri.js';
+import { R as RuntimeCapabilities } from '../capabilities-C4Dqs_pB.js';
+export { B as BROWSER_WASM_RUNTIME_CAPABILITIES, c as BrowserRuntimeCapabilityHost, N as NATIVE_IPC_RUNTIME_CAPABILITIES, d as NativeRuntimeStatusSnapshot, e as NativeRuntimeTransportFeatureStatus, b as RuntimeAdapterKind, a as RuntimeCapabilityProfile, f as cloneRuntimeCapabilities, r as runtimeCapabilitiesForBrowserHost, g as runtimeCapabilitiesFromNativeStatus, h as runtimeCapabilityProfile } from '../capabilities-C4Dqs_pB.js';
+export { RuntimeDeviceActiveOptions, isRuntimeDeviceActive, isRuntimeDeviceConnectable, isRuntimeDeviceRoutable } from './device-status.js';
+export { h as RuntimeJsonFrameDecoderOptions, R as RuntimeJsonFrameHandler, a as RuntimeU32BEFrameHandler, i as concatRuntimeBytes, c as createRuntimeJsonFrameDecoder, b as createRuntimeU32BEFrameDecoder, d as decodeRuntimeJsonPayload, e as encodeRuntimeJsonFrame, f as encodeRuntimeJsonPayload, g as encodeRuntimeU32BEFrame, r as readRuntimeU32BE } from '../framing-zRvEKOld.js';
+import { I as IpcRuntimeAdapter } from '../tauri-WEvOC_Z6.js';
+export { a as IpcRuntimeAdapterOptions, T as TauriRuntimeAdapter, b as TauriRuntimeAdapterOptions, c as createTauriIpcBridge } from '../tauri-WEvOC_Z6.js';
+import { WasmRuntimeAdapter } from './WasmRuntimeAdapter.js';
+import { P as PlutoIpcBridge } from '../ipc-CflAVodw.js';
+export { N as NativeIpcFailureKind, a as PlutoIpcUnlisten, c as classifyNativeIpcFailure, i as isNativeIpcCommandUnavailable } from '../ipc-CflAVodw.js';
 import '../IEngineBridge-C7OT2CRv.js';
+import '../DelegatingRuntimeAdapter-lFDUNBy9.js';
 
 /**
  * RtdbPresence — Phase 1 RTDB-backed device presence.
@@ -183,6 +188,18 @@ declare class Signaling {
     setWasmClient(client: any): void;
 }
 
+/**
+ * @deprecated Legacy assembly helper. Use `OpenRTC()` for app code.
+ * Removal target: OpenRTC 0.2.0.
+ */
+declare function createWasmClient(options: RuntimeFactoryOptions): PlutoRuntimeAssembly<WasmRuntimeAdapter>;
+/**
+ * @deprecated Legacy assembly helper. Native applications should use
+ * `createNativeOpenRTC` from `openrtc/native`.
+ * Removal target: OpenRTC 0.2.0.
+ */
+declare function createIpcClient(options: RuntimeFactoryOptions, bridge: PlutoIpcBridge): PlutoRuntimeAssembly<IpcRuntimeAdapter>;
+
 interface MoQSubscriberOptions {
     maxPendingSubscriptions?: number;
     maxSubscribeRetries?: number;
@@ -623,4 +640,4 @@ declare function openRtcDebug(message: string, data?: unknown): void;
 declare function openRtcDebugInfo(message: string, data?: unknown): void;
 declare function openRtcDebugLog(message: string, data?: unknown): void;
 
-export { type CorrelationFields, RuntimeCapabilities, RuntimeConnectionController, RuntimeConnectionTarget, RuntimeRawConnection, clog, correlationForDriveGrantScope, logOpenRtcTeardownTrace, openRtcDebug, openRtcDebugEnabled, openRtcDebugInfo, openRtcDebugLog, renderCorrelationFields };
+export { type CorrelationFields, IpcRuntimeAdapter, PlutoIpcBridge as NativeBridge, PlutoIpcBridge, PlutoRuntimeAssembly, RuntimeCapabilities, RuntimeConnectionController, RuntimeConnectionTarget, RuntimeFactoryOptions, RuntimeRawConnection, WasmRuntimeAdapter, clog, correlationForDriveGrantScope, createIpcClient, createWasmClient, logOpenRtcTeardownTrace, openRtcDebug, openRtcDebugEnabled, openRtcDebugInfo, openRtcDebugLog, renderCorrelationFields };

package/dist/runtime/index.js

@@ -1 +1 @@
-export{y as RuntimeClient,h as RuntimeConnectionController,l as ScopedConnectionActorError,o as ScopedConnectionActorHandle,p as ScopedConnectionActorRegistry,k as clog,w as concatRuntimeBytes,j as correlationForDriveGrantScope,A as createIpcClient,v as createRuntimeJsonFrameDecoder,r as createRuntimeU32BEFrameDecoder,z as createWasmClient,t as decodeRuntimeJsonPayload,u as encodeRuntimeJsonFrame,s as encodeRuntimeJsonPayload,q as encodeRuntimeU32BEFrame,x as readRuntimeU32BE,i as renderCorrelationFields,m as scopedConnectionKey,n as scopedConnectionKeyToString}from'../chunk-NCRP5ODV.js';export{a as isRuntimeDeviceActive,c as isRuntimeDeviceConnectable,b as isRuntimeDeviceRoutable}from'../chunk-CK6WQV7J.js';export{a as WasmRuntimeAdapter}from'../chunk-BGQX25BO.js';export{b as TauriRuntimeAdapter,a as createTauriIpcBridge}from'../chunk-RRCARL4S.js';export{h as IpcRuntimeAdapter,e as classifyNativeIpcFailure,f as isNativeIpcCommandUnavailable}from'../chunk-L6OUJ6YN.js';export{y as BROWSER_WASM_RUNTIME_CAPABILITIES,z as NATIVE_IPC_RUNTIME_CAPABILITIES,w as OPENRTC_RUNTIME_POLICY,A as cloneRuntimeCapabilities,x as getRuntimePolicy,o as logOpenRtcTeardownTrace,b as openRtcDebug,a as openRtcDebugEnabled,c as openRtcDebugInfo,d as openRtcDebugLog,B as runtimeCapabilitiesForBrowserHost,C as runtimeCapabilitiesFromNativeStatus,D as runtimeCapabilityProfile}from'../chunk-MESPJTUA.js';import'../chunk-34LATQZZ.js';import'../chunk-QT2ASNI3.js';import'../chunk-C7YN5MSV.js';
+export{b as createIpcClient,a as createWasmClient}from'../chunk-4AXAWVC6.js';export{z as RuntimeClient,i as RuntimeConnectionController,m as ScopedConnectionActorError,p as ScopedConnectionActorHandle,q as ScopedConnectionActorRegistry,l as clog,x as concatRuntimeBytes,k as correlationForDriveGrantScope,w as createRuntimeJsonFrameDecoder,s as createRuntimeU32BEFrameDecoder,u as decodeRuntimeJsonPayload,v as encodeRuntimeJsonFrame,t as encodeRuntimeJsonPayload,r as encodeRuntimeU32BEFrame,y as readRuntimeU32BE,j as renderCorrelationFields,n as scopedConnectionKey,o as scopedConnectionKeyToString}from'../chunk-7352ZIXN.js';export{a as isRuntimeDeviceActive,c as isRuntimeDeviceConnectable,b as isRuntimeDeviceRoutable}from'../chunk-CK6WQV7J.js';export{a as WasmRuntimeAdapter}from'../chunk-MNI6JGR2.js';export{b as TauriRuntimeAdapter,a as createTauriIpcBridge}from'../chunk-N6UBUNGC.js';export{h as IpcRuntimeAdapter,e as classifyNativeIpcFailure,f as isNativeIpcCommandUnavailable}from'../chunk-DI5IPRPM.js';export{y as BROWSER_WASM_RUNTIME_CAPABILITIES,z as NATIVE_IPC_RUNTIME_CAPABILITIES,w as OPENRTC_RUNTIME_POLICY,A as cloneRuntimeCapabilities,x as getRuntimePolicy,o as logOpenRtcTeardownTrace,b as openRtcDebug,a as openRtcDebugEnabled,c as openRtcDebugInfo,d as openRtcDebugLog,B as runtimeCapabilitiesForBrowserHost,C as runtimeCapabilitiesFromNativeStatus,D as runtimeCapabilityProfile}from'../chunk-YTUWXCRO.js';import'../chunk-QT2ASNI3.js';import'../chunk-HVTYSEU7.js';import'../chunk-C7YN5MSV.js';

package/dist/runtime/tauri.d.ts

@@ -1,20 +1,6 @@
-import { I as IpcRuntimeAdapter, N as NativeIpcBridgeOptions, P as PlutoIpcBridge } from '../IpcRuntimeAdapter-B8rkqNrq.js';
-import '../types-ByZyADCn.js';
-import '../DelegatingRuntimeAdapter-D2_dgabz.js';
+export { T as TauriRuntimeAdapter, b as TauriRuntimeAdapterOptions, c as createTauriIpcBridge } from '../tauri-WEvOC_Z6.js';
+import '../ipc-CflAVodw.js';
+import '../types-ZDsZknDI.js';
+import '../DelegatingRuntimeAdapter-lFDUNBy9.js';
 import '../IEngineBridge-C7OT2CRv.js';
-
-/**
- * @deprecated Native Tauri support now lives in the first-party `openrtc-tauri` package.
- * Removal target: OpenRTC 0.2.0. This shim remains for one compatibility cycle.
- */
-declare function createTauriIpcBridge(): PlutoIpcBridge;
-/**
- * @deprecated Native Tauri support now lives in the first-party `openrtc-tauri` package.
- * Removal target: OpenRTC 0.2.0. This shim remains for one compatibility cycle.
- */
-declare class TauriRuntimeAdapter extends IpcRuntimeAdapter {
-    constructor(options: NativeIpcBridgeOptions);
-}
-type TauriRuntimeAdapterOptions = NativeIpcBridgeOptions;
-
-export { TauriRuntimeAdapter, type TauriRuntimeAdapterOptions, createTauriIpcBridge };
+import '../capabilities-C4Dqs_pB.js';