@cello-protocol/client 0.0.21 → 0.0.23

package/dist/signaling-manager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * SignalingManager — persistent signaling stream, frame router, per-session directory streams.
+ *
+ * Extracted from CelloClientImpl. Owns all persistent signaling stream state:
+ *   #persistentSignalingStream, #persistentSignalingIter, #openingSignalingStream,
+ *   #pendingSessionRequestResolve, #pendingRegisterResolve, #pendingDkgReadyResolve.
+ */
+import type { Stream } from "@libp2p/interface";
+import type { Logger } from "@cello-protocol/interfaces";
+import type { CelloNode } from "@cello-protocol/transport";
+import type { KeyProvider } from "@cello-protocol/crypto";
+import type { SessionAssignment } from "@cello-protocol/protocol-types";
+import type { InitiateSessionResult, ReceiveAssignmentResult, SessionRecord } from "./types.js";
+/**
+ * Narrow interface exposing only what SignalingManager needs from CelloClientImpl.
+ */
+export interface SignalingContext {
+    readonly node: CelloNode;
+    readonly keyProvider: KeyProvider;
+    readonly logger: Logger;
+    getMyPubkeyHex(): string | null;
+    setMyPubkeyHex(hex: string): void;
+    getDirectoryEndpoint(): {
+        peer_id: string;
+        multiaddrs: string[];
+    } | null;
+    getDirectoryStream(sessionIdHex: string): Stream | undefined;
+    setDirectoryStream(sessionIdHex: string, stream: Stream): void;
+    deleteDirectoryStream(sessionIdHex: string): void;
+    getPendingConnectionResolverCount(): number;
+    dispatchSignalingFrame(stream: Stream, frame: Record<string, unknown>): void;
+    onSignalingStreamClosed(stream: Stream): void;
+    getConnectionIdForPeer(pubkeyHex: string): string | undefined;
+    hasConnectionPolicy(): boolean;
+    receiveSessionAssignment(assignment: SessionAssignment, myPubkey: Uint8Array): Promise<ReceiveAssignmentResult>;
+    getSession(sessionIdHex: string): SessionRecord | undefined;
+}
+export declare class SignalingManager {
+    #private;
+    constructor(ctx: SignalingContext);
+    getPersistentSignalingStream(): Stream | null;
+    setPersistentSignalingStream(stream: Stream | null): void;
+    setPersistentSignalingIter(iter: AsyncIterator<Uint8Array> | null): void;
+    hasPendingSessionRequest(): boolean;
+    hasPendingRegister(): boolean;
+    hasPendingDkgReady(): boolean;
+    getPendingSessionRequestResolve(): ((frame: Record<string, unknown>) => void) | null;
+    setPendingSessionRequestResolve(resolve: ((frame: Record<string, unknown>) => void) | null): void;
+    setPendingRegisterResolve(resolve: ((frame: Record<string, unknown>) => void) | null): void;
+    setPendingDkgReadyResolve(resolve: ((frame: Record<string, unknown>) => void) | null): void;
+    resolvePendingRegister(frame: Record<string, unknown>): void;
+    resolvePendingDkgReady(frame: Record<string, unknown>): void;
+    /**
+     * Called when the signaling stream closes. Unblocks all pending resolvers.
+     */
+    onStreamClosed(stream: Stream): void;
+    /**
+     * Open and authenticate the persistent directory signaling stream.
+     * Serializes concurrent calls.
+     */
+    openPersistentSignalingStream(directoryPeerId?: string, directoryMultiaddr?: string): Promise<boolean>;
+    /**
+     * Reconnect the persistent signaling stream.
+     */
+    reconnectDirectory(): Promise<boolean>;
+    /**
+     * Open per-session directory signaling stream (SESSION-003).
+     */
+    connectDirectorySignalingStream(sessionIdHex: string, assignment: SessionAssignment, myPubkey: Uint8Array): Promise<void>;
+    /**
+     * FEDERATION-003 AC-004: Look up a relay's registered public key from the directory.
+     */
+    getRelayPublicKey(relayId: string): Promise<string | undefined>;
+    runPersistentSignalingReader(stream: Stream, iter: AsyncIterator<Uint8Array>): void;
+    /**
+     * ADAPTER-003: Send session_request on the persistent signaling stream and await
+     * session_assignment or error. SI-002: K_local never appears in any frame or log.
+     */
+    initiateSession(targetPubkeyHex: string, opts?: {
+        directoryPeerId?: string;
+        directoryMultiaddr?: string;
+        timeoutMs?: number;
+    }): Promise<InitiateSessionResult>;
+}
+//# sourceMappingURL=signaling-manager.d.ts.map

package/dist/signaling-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signaling-manager.d.ts","sourceRoot":"","sources":["../src/signaling-manager.ts"],"names":[],"mappings":"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"}