dropspace 0.0.0-stage → 0.1.1

package/dist/protocol/framing.d.ts

@@ -0,0 +1,69 @@
+export declare const WIRE_MAGIC_BYTE = 213;
+export declare const WIRE_PREFIX_BYTES = 6;
+export declare enum WireFrameType {
+    CONTROL_JSON = 1,
+    MESSAGE_JSON = 2,
+    MESSAGE_BINARY = 3,
+    TRANSFER_CONTROL = 4,
+    TRANSFER_CHUNK = 5,
+    CRDT_SYNC = 6,
+    HUB_RELAY = 7
+}
+export type AckSemantics = "received" | "persisted" | "processed";
+export interface WireFrameHeader {
+    messageId: string;
+    channel: string;
+    timestamp: number;
+    chunkIndex?: number;
+    totalChunks?: number;
+    totalByteLength?: number;
+    ackRequired?: boolean;
+    ackMode?: AckSemantics;
+    correlationId?: string;
+    /** File transfer specific fields */
+    transferId?: string;
+    byteOffset?: number;
+    chunkHash?: string;
+    /** CRDT specific fields */
+    documentId?: string;
+    /** Hub relay specific fields */
+    sourceDeviceId?: string;
+    targetDeviceId?: string;
+    spaceId?: string;
+    hopCount?: number;
+    maxHops?: number;
+    /** Custom metadata */
+    meta?: Record<string, unknown>;
+}
+export interface DecodedWireFrame {
+    frameType: WireFrameType;
+    header: WireFrameHeader;
+    payload: Uint8Array;
+}
+export interface EncodeWireFrameOptions {
+    /** Maximum allowed total frame size in bytes (prefix + header + payload). Defaults to 64 KiB. */
+    maxTotalFrameBytes?: number;
+}
+export interface DecodeWireFrameOptions {
+    /** Maximum allowed total frame size in bytes when decoding. Defaults to 256 KiB. */
+    maxTotalFrameBytes?: number;
+}
+export declare const MAX_HEADER_BYTES: number;
+export declare const DEFAULT_MAX_TOTAL_FRAME_BYTES: number;
+export declare const DEFAULT_MAX_FRAME_PAYLOAD_BYTES: number;
+export declare const MAX_DECODE_FRAME_BYTES: number;
+/**
+ * Binary frame layout:
+ * Byte 0: WIRE_MAGIC_BYTE (0xD5)
+ * Byte 1: WireFrameType (0x01 .. 0x07)
+ * Bytes 2..5: Header byte length (uint32 big-endian)
+ * Bytes 6..(6 + headerLen - 1): UTF-8 JSON encoded WireFrameHeader
+ * Remaining bytes: Raw binary payload (Uint8Array)
+ *
+ * totalFrameBytes = WIRE_PREFIX_BYTES (6) + encodedHeaderBytes + payloadBytes
+ */
+export declare function encodeWireFrame(frameType: WireFrameType, header: WireFrameHeader, payload?: Uint8Array, options?: EncodeWireFrameOptions): Uint8Array;
+export declare function decodeWireFrame(raw: Uint8Array | ArrayBuffer, options?: DecodeWireFrameOptions): DecodedWireFrame;
+export declare function encodeJsonPayload(value: unknown): Uint8Array;
+export declare function decodeJsonPayload<T = unknown>(payload: Uint8Array): T;
+//# sourceMappingURL=framing.d.ts.map

package/dist/protocol/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../src/protocol/framing.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,MAAO,CAAC;AACpC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,oBAAY,aAAa;IACvB,YAAY,IAAO;IACnB,YAAY,IAAO;IACnB,cAAc,IAAO;IACrB,gBAAgB,IAAO;IACvB,cAAc,IAAO;IACrB,SAAS,IAAO;IAChB,SAAS,IAAO;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,iGAAiG;IACjG,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAKD,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAC1C,eAAO,MAAM,6BAA6B,QAAY,CAAC;AACvD,eAAO,MAAM,+BAA+B,QAAY,CAAC;AACzD,eAAO,MAAM,sBAAsB,QAAa,CAAC;AA+CjD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,UAA8B,EACvC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,UAAU,CA+CZ;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,GAAG,WAAW,EAC7B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,gBAAgB,CA+ElB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAE5D;AAED,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,UAAU,GAAG,CAAC,CAErE"}

package/dist/protocol/framing.js

@@ -0,0 +1,145 @@
+import { ProtocolValidationError } from "./envelope.js";
+export const WIRE_MAGIC_BYTE = 0xd5;
+export const WIRE_PREFIX_BYTES = 6;
+export var WireFrameType;
+(function (WireFrameType) {
+    WireFrameType[WireFrameType["CONTROL_JSON"] = 1] = "CONTROL_JSON";
+    WireFrameType[WireFrameType["MESSAGE_JSON"] = 2] = "MESSAGE_JSON";
+    WireFrameType[WireFrameType["MESSAGE_BINARY"] = 3] = "MESSAGE_BINARY";
+    WireFrameType[WireFrameType["TRANSFER_CONTROL"] = 4] = "TRANSFER_CONTROL";
+    WireFrameType[WireFrameType["TRANSFER_CHUNK"] = 5] = "TRANSFER_CHUNK";
+    WireFrameType[WireFrameType["CRDT_SYNC"] = 6] = "CRDT_SYNC";
+    WireFrameType[WireFrameType["HUB_RELAY"] = 7] = "HUB_RELAY";
+})(WireFrameType || (WireFrameType = {}));
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder("utf-8", { fatal: true });
+export const MAX_HEADER_BYTES = 16 * 1024; // 16 KiB header limit
+export const DEFAULT_MAX_TOTAL_FRAME_BYTES = 64 * 1024; // 64 KiB safe WebRTC SCTP baseline
+export const DEFAULT_MAX_FRAME_PAYLOAD_BYTES = 48 * 1024; // 48 KiB payload leaves room for prefix + header within 64 KiB
+export const MAX_DECODE_FRAME_BYTES = 256 * 1024; // 256 KiB max incoming frame guard
+function validateFrameTypeSpecificHeader(frameType, header) {
+    if (typeof header.timestamp !== "number" || !Number.isFinite(header.timestamp)) {
+        throw new ProtocolValidationError("Wire frame header requires finite numeric timestamp", "header.timestamp");
+    }
+    if (frameType === WireFrameType.TRANSFER_CHUNK) {
+        if (!header.transferId || typeof header.transferId !== "string") {
+            throw new ProtocolValidationError("TRANSFER_CHUNK frame requires header.transferId", "header.transferId");
+        }
+        if (typeof header.byteOffset !== "number" ||
+            !Number.isFinite(header.byteOffset) ||
+            header.byteOffset < 0) {
+            throw new ProtocolValidationError("TRANSFER_CHUNK frame requires non-negative header.byteOffset", "header.byteOffset");
+        }
+    }
+    else if (frameType === WireFrameType.CRDT_SYNC) {
+        if (!header.documentId || typeof header.documentId !== "string") {
+            throw new ProtocolValidationError("CRDT_SYNC frame requires header.documentId", "header.documentId");
+        }
+    }
+    else if (frameType === WireFrameType.HUB_RELAY) {
+        if (!header.targetDeviceId || typeof header.targetDeviceId !== "string") {
+            throw new ProtocolValidationError("HUB_RELAY frame requires header.targetDeviceId", "header.targetDeviceId");
+        }
+    }
+}
+/**
+ * Binary frame layout:
+ * Byte 0: WIRE_MAGIC_BYTE (0xD5)
+ * Byte 1: WireFrameType (0x01 .. 0x07)
+ * Bytes 2..5: Header byte length (uint32 big-endian)
+ * Bytes 6..(6 + headerLen - 1): UTF-8 JSON encoded WireFrameHeader
+ * Remaining bytes: Raw binary payload (Uint8Array)
+ *
+ * totalFrameBytes = WIRE_PREFIX_BYTES (6) + encodedHeaderBytes + payloadBytes
+ */
+export function encodeWireFrame(frameType, header, payload = new Uint8Array(0), options) {
+    if (frameType < WireFrameType.CONTROL_JSON || frameType > WireFrameType.HUB_RELAY) {
+        throw new ProtocolValidationError(`Unknown wire frame type: 0x${Number(frameType).toString(16)}`, "frameType");
+    }
+    if (!header.messageId || typeof header.messageId !== "string") {
+        throw new ProtocolValidationError("WireFrameHeader requires messageId", "header.messageId");
+    }
+    if (!header.channel || typeof header.channel !== "string") {
+        throw new ProtocolValidationError("WireFrameHeader requires channel", "header.channel");
+    }
+    validateFrameTypeSpecificHeader(frameType, header);
+    const headerBytes = textEncoder.encode(JSON.stringify(header));
+    if (headerBytes.byteLength > MAX_HEADER_BYTES) {
+        throw new ProtocolValidationError(`WireFrameHeader exceeds ${MAX_HEADER_BYTES} bytes`, "header", "MESSAGE_TOO_LARGE");
+    }
+    const totalLength = WIRE_PREFIX_BYTES + headerBytes.byteLength + payload.byteLength;
+    const maxTotal = options?.maxTotalFrameBytes ?? DEFAULT_MAX_TOTAL_FRAME_BYTES;
+    if (totalLength > maxTotal) {
+        throw new ProtocolValidationError(`Wire frame total size (${totalLength} bytes) exceeds limit (${maxTotal} bytes)`, "frame", "MESSAGE_TOO_LARGE");
+    }
+    const buffer = new Uint8Array(totalLength);
+    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    view.setUint8(0, WIRE_MAGIC_BYTE);
+    view.setUint8(1, frameType);
+    view.setUint32(2, headerBytes.byteLength, false);
+    buffer.set(headerBytes, WIRE_PREFIX_BYTES);
+    if (payload.byteLength > 0) {
+        buffer.set(payload, WIRE_PREFIX_BYTES + headerBytes.byteLength);
+    }
+    return buffer;
+}
+export function decodeWireFrame(raw, options) {
+    const bytes = raw instanceof Uint8Array ? raw : new Uint8Array(raw);
+    const maxTotal = options?.maxTotalFrameBytes ?? MAX_DECODE_FRAME_BYTES;
+    if (bytes.byteLength > maxTotal) {
+        throw new ProtocolValidationError(`Wire frame size (${bytes.byteLength} bytes) exceeds limit (${maxTotal} bytes)`, "frame", "MESSAGE_TOO_LARGE");
+    }
+    if (bytes.byteLength < WIRE_PREFIX_BYTES) {
+        throw new ProtocolValidationError(`Wire frame too short (${bytes.byteLength} bytes, minimum ${WIRE_PREFIX_BYTES})`, "frame");
+    }
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const magic = view.getUint8(0);
+    if (magic !== WIRE_MAGIC_BYTE) {
+        throw new ProtocolValidationError(`Invalid wire frame magic byte: 0x${magic.toString(16)}`, "magic");
+    }
+    const frameType = view.getUint8(1);
+    if (frameType < WireFrameType.CONTROL_JSON || frameType > WireFrameType.HUB_RELAY) {
+        throw new ProtocolValidationError(`Unknown wire frame type: 0x${frameType.toString(16)}`, "frameType");
+    }
+    const headerLength = view.getUint32(2, false);
+    if (headerLength === 0 || headerLength > MAX_HEADER_BYTES || WIRE_PREFIX_BYTES + headerLength > bytes.byteLength) {
+        throw new ProtocolValidationError(`Invalid wire frame header length: ${headerLength}`, "headerLength");
+    }
+    const headerSlice = bytes.subarray(WIRE_PREFIX_BYTES, WIRE_PREFIX_BYTES + headerLength);
+    let headerJson;
+    try {
+        headerJson = textDecoder.decode(headerSlice);
+    }
+    catch {
+        throw new ProtocolValidationError("Invalid UTF-8 in wire frame header", "header");
+    }
+    let header;
+    try {
+        header = JSON.parse(headerJson);
+    }
+    catch {
+        throw new ProtocolValidationError("Malformed JSON in wire frame header", "header");
+    }
+    if (typeof header !== "object" ||
+        header === null ||
+        typeof header.messageId !== "string" ||
+        header.messageId.length === 0 ||
+        typeof header.channel !== "string" ||
+        header.channel.length === 0) {
+        throw new ProtocolValidationError("Wire frame header missing messageId or channel", "header");
+    }
+    validateFrameTypeSpecificHeader(frameType, header);
+    const payload = bytes.subarray(WIRE_PREFIX_BYTES + headerLength);
+    return {
+        frameType,
+        header,
+        payload,
+    };
+}
+export function encodeJsonPayload(value) {
+    return textEncoder.encode(JSON.stringify(value));
+}
+export function decodeJsonPayload(payload) {
+    return JSON.parse(textDecoder.decode(payload));
+}
+//# sourceMappingURL=framing.js.map

package/dist/protocol/framing.js.map

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

package/dist/protocol/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./envelope.js";
+export * from "./framing.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/protocol/index.js

@@ -0,0 +1,3 @@
+export * from "./envelope.js";
+export * from "./framing.js";
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/fixtures/envelopes.json

@@ -0,0 +1,132 @@
+{
+  "valid": [
+    {
+      "name": "auth_authenticate_v1",
+      "envelope": {
+        "protocolVersion": 1,
+        "type": "auth.authenticate",
+        "requestId": "req-auth-001",
+        "payload": {
+          "sessionToken": "tok_live_987654321",
+          "deviceLabel": "MacBook Pro",
+          "capabilities": ["messaging", "files", "crdt"]
+        }
+      }
+    },
+    {
+      "name": "webrtc_offer_with_generation",
+      "envelope": {
+        "protocolVersion": 1,
+        "type": "webrtc.offer",
+        "requestId": "req-offer-01",
+        "sessionId": "sess-001",
+        "connectionId": "conn-abc-123",
+        "generation": 2,
+        "spaceId": "space-main",
+        "senderDeviceId": "dev-alice",
+        "targetDeviceId": "dev-bob",
+        "payload": {
+          "sdp": "v=0\r\no=- 4611731400430051336 2 IN IP4 127.0.0.1\r\ns=-\r\nt=0 0\r\n",
+          "tieBreaker": "dev-alice"
+        }
+      }
+    },
+    {
+      "name": "webrtc_ice_candidate_v1",
+      "envelope": {
+        "protocolVersion": 1,
+        "type": "webrtc.ice_candidate",
+        "connectionId": "conn-abc-123",
+        "generation": 2,
+        "spaceId": "space-main",
+        "senderDeviceId": "dev-alice",
+        "targetDeviceId": "dev-bob",
+        "payload": {
+          "candidate": "candidate:842163049 1 udp 1677729535 192.168.1.10 54321 typ srflx",
+          "sdpMid": "0",
+          "sdpMLineIndex": 0
+        }
+      }
+    },
+    {
+      "name": "pairing_awaiting_approval_v1",
+      "envelope": {
+        "protocolVersion": 1,
+        "type": "pairing.awaiting_approval",
+        "spaceId": "space-main",
+        "targetDeviceId": "dev-alice",
+        "payload": {
+          "pairingId": "pair-101",
+          "claimerDeviceId": "dev-bob",
+          "claimerLabel": "Bob's iPad",
+          "claimerFingerprint": "sha256:abcdef0123456789",
+          "claimerAlgorithm": "ECDSA_P256_SHA256",
+          "requestedPermissions": ["connect", "messaging", "files"]
+        }
+      }
+    },
+    {
+      "name": "revocation_notice_v1",
+      "envelope": {
+        "protocolVersion": 1,
+        "type": "revocation.notice",
+        "spaceId": "space-main",
+        "payload": {
+          "revokedDeviceId": "dev-bob",
+          "pairingId": "pair-101",
+          "revokedByDeviceId": "dev-alice",
+          "revokedAt": 1762956000000,
+          "reason": "User revoked device access"
+        }
+      }
+    }
+  ],
+  "invalid": [
+    {
+      "name": "wrong_protocol_version",
+      "expectedCode": "UNSUPPORTED_PROTOCOL_VERSION",
+      "envelope": {
+        "protocolVersion": 2,
+        "type": "heartbeat.ping",
+        "payload": { "clientTime": 1000 }
+      }
+    },
+    {
+      "name": "unknown_message_type",
+      "expectedCode": "INVALID_ENVELOPE",
+      "envelope": {
+        "protocolVersion": 1,
+        "type": "unknown.custom_event",
+        "payload": {}
+      }
+    },
+    {
+      "name": "offer_missing_generation",
+      "expectedCode": "INVALID_ENVELOPE",
+      "envelope": {
+        "protocolVersion": 1,
+        "type": "webrtc.offer",
+        "connectionId": "conn-abc-123",
+        "targetDeviceId": "dev-bob",
+        "payload": {
+          "sdp": "v=0..."
+        }
+      }
+    },
+    {
+      "name": "negative_generation",
+      "expectedCode": "INVALID_ENVELOPE",
+      "envelope": {
+        "protocolVersion": 1,
+        "type": "webrtc.answer",
+        "connectionId": "conn-abc-123",
+        "generation": -1,
+        "targetDeviceId": "dev-bob",
+        "payload": {
+          "sdp": "v=0..."
+        }
+      }
+    }
+  ]
+}
+

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "dropspace",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "End-to-end encrypted peer-to-peer rooms, resumable file transfers, and Automerge CRDT sync over WebRTC & WebSocket.",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "dropspace": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "fixtures",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./files": {
+      "types": "./dist/files/index.d.ts",
+      "import": "./dist/files/index.js"
+    },
+    "./automerge": {
+      "types": "./dist/automerge/index.d.ts",
+      "import": "./dist/automerge/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol/index.d.ts",
+      "import": "./dist/protocol/index.js"
+    },
+    "./fixtures/envelopes.json": "./fixtures/envelopes.json"
+  },
+  "dependencies": {
+    "@automerge/automerge": "^2.2.8",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "@types/ws": "^8.5.13"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}
+