dropspace 0.0.0-stage → 0.1.0

package/dist/client/channel.d.ts

@@ -0,0 +1,131 @@
+import { WireFrameType, type AckSemantics, type WireFrameHeader, type DecodedWireFrame } from "../protocol/index.js";
+import { TypedEventEmitter } from "./events.js";
+export interface DataChannelLike {
+    readonly label: string;
+    readyState: "connecting" | "open" | "closing" | "closed";
+    bufferedAmount: number;
+    bufferedAmountLowThreshold: number;
+    binaryType?: BinaryType;
+    send(data: Uint8Array | ArrayBuffer): void;
+    close(): void;
+    addEventListener(type: string, listener: (ev: any) => void): void;
+    removeEventListener(type: string, listener: (ev: any) => void): void;
+}
+export interface SendMessageOptions {
+    channel?: string;
+    messageId?: string;
+    ack?: AckSemantics | false;
+    ackTimeoutMs?: number;
+    maxRetries?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    viaHubDeviceId?: string;
+    spaceId?: string;
+    maxHops?: number;
+    meta?: Record<string, unknown>;
+}
+export interface IncomingMessageEvent {
+    peerDeviceId: string;
+    channel: string;
+    messageId: string;
+    frameType: WireFrameType;
+    header: WireFrameHeader;
+    binary: Uint8Array;
+    json?: unknown;
+    routedViaHub?: string;
+    /** Call when using manual `persisted` or `processed` ACK semantics */
+    acknowledge(semantics?: AckSemantics): Promise<void>;
+}
+export declare class MessagingError extends Error {
+    readonly code: "QUEUE_OVERFLOW" | "CHANNEL_CLOSED" | "ABORTED" | "TIMEOUT" | "ACK_TIMEOUT" | "MESSAGE_TOO_LARGE" | "HUB_ROUTE_FAILED";
+    constructor(message: string, code: "QUEUE_OVERFLOW" | "CHANNEL_CLOSED" | "ABORTED" | "TIMEOUT" | "ACK_TIMEOUT" | "MESSAGE_TOO_LARGE" | "HUB_ROUTE_FAILED");
+}
+export interface ChannelMultiplexerOptions {
+    peerDeviceId: string;
+    localDeviceId: string;
+    maxFramePayloadBytes?: number;
+    bufferedAmountHighWaterMark?: number;
+    bufferedAmountLowWaterMark?: number;
+    maxSendQueueFrames?: number;
+    maxSendQueueBytes?: number;
+    dedupWindowMs?: number;
+    maxDedupEntries?: number;
+    onRawFrame?: (frame: DecodedWireFrame) => void;
+}
+export type ChannelMultiplexerEvents = {
+    message: IncomingMessageEvent;
+    transferFrame: DecodedWireFrame;
+    crdtFrame: DecodedWireFrame;
+    hubRelayFrame: DecodedWireFrame;
+    backpressureChange: {
+        bufferedAmount: number;
+        queuedBytes: number;
+        paused: boolean;
+    };
+    error: Error;
+    close: void;
+};
+/**
+ * Reliable binary-first framing, chunking, backpressure queue, and optional application ACK engine
+ * over an underlying `RTCDataChannel` (Section 13).
+ *
+ * Important Transport Note:
+ * Even an ordered, reliable `RTCDataChannel` only guarantees SCTP in-order delivery within a single
+ * active transport association. Across reconnects or new `RTCPeerConnection` instances, in-flight
+ * SCTP packets can be lost or re-sent. Enable `ack: "received" | "persisted" | "processed"` when
+ * application-level delivery confirmation and deduplication across retries are required.
+ */
+export declare class PeerChannelMultiplexer {
+    private readonly options;
+    readonly events: TypedEventEmitter<ChannelMultiplexerEvents>;
+    private dataChannel;
+    private readonly maxFramePayloadBytes;
+    private readonly highWaterMark;
+    private readonly lowWaterMark;
+    private readonly maxQueueFrames;
+    private readonly maxQueueBytes;
+    private readonly dedupWindowMs;
+    private readonly maxDedupEntries;
+    private readonly sendQueue;
+    private queuedBytes;
+    private isFlushing;
+    private backpressurePaused;
+    private closed;
+    private readonly pendingAcks;
+    private readonly seenMessageIds;
+    private readonly partialAssemblies;
+    private readonly boundOnMessage;
+    private readonly boundOnBufferedAmountLow;
+    private readonly boundOnClose;
+    constructor(options: ChannelMultiplexerOptions);
+    attachDataChannel(dc: DataChannelLike): void;
+    detachDataChannel(): void;
+    getQueueMetrics(): {
+        queuedFrames: number;
+        queuedBytes: number;
+        bufferedAmount: number;
+    };
+    sendBinary(payload: Uint8Array, options?: SendMessageOptions): Promise<{
+        messageId: string;
+        ackSemantics?: AckSemantics;
+    }>;
+    sendJson(value: unknown, options?: SendMessageOptions): Promise<{
+        messageId: string;
+        ackSemantics?: AckSemantics;
+    }>;
+    sendRawWireFrame(frameType: WireFrameType, header: WireFrameHeader, payload?: Uint8Array, signal?: AbortSignal): Promise<void>;
+    private sendInternal;
+    private waitForAck;
+    private enqueueEncodedFrame;
+    private flushQueue;
+    private waitForBufferDrain;
+    private handleIncomingRaw;
+    private handleControlFrame;
+    private handleApplicationFrame;
+    deliverHubUnwrappedFrame(innerFrame: DecodedWireFrame, hubDeviceId: string): void;
+    private deliverReassembledMessage;
+    private pruneDeduplicationMap;
+    private rejectQueuedFrames;
+    close(): void;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/client/channel.d.ts.map

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