dropspace 0.0.0-stage → 0.1.0

package/dist/protocol/framing.d.ts

@@ -0,0 +1,56 @@
+export declare const WIRE_MAGIC_BYTE = 213;
+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 declare const MAX_HEADER_BYTES: number;
+export declare const DEFAULT_MAX_FRAME_PAYLOAD_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)
+ */
+export declare function encodeWireFrame(frameType: WireFrameType, header: WireFrameHeader, payload?: Uint8Array): Uint8Array;
+export declare function decodeWireFrame(raw: Uint8Array | ArrayBuffer): 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;AAEpC,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;AAKD,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAC1C,eAAO,MAAM,+BAA+B,QAAY,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,UAA8B,GACtC,UAAU,CA+BZ;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,GAAG,gBAAgB,CA4D/E;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,93 @@
+import { ProtocolValidationError } from "./envelope.js";
+export const WIRE_MAGIC_BYTE = 0xd5;
+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();
+export const MAX_HEADER_BYTES = 16 * 1024; // 16 KiB header limit
+export const DEFAULT_MAX_FRAME_PAYLOAD_BYTES = 64 * 1024; // 64 KiB safe WebRTC DataChannel chunk size
+/**
+ * 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)
+ */
+export function encodeWireFrame(frameType, header, payload = new Uint8Array(0)) {
+    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");
+    }
+    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 = 6 + headerBytes.byteLength + payload.byteLength;
+    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, 6);
+    if (payload.byteLength > 0) {
+        buffer.set(payload, 6 + headerBytes.byteLength);
+    }
+    return buffer;
+}
+export function decodeWireFrame(raw) {
+    const bytes = raw instanceof Uint8Array ? raw : new Uint8Array(raw);
+    if (bytes.byteLength < 6) {
+        throw new ProtocolValidationError(`Wire frame too short (${bytes.byteLength} bytes, minimum 6)`, "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 > MAX_HEADER_BYTES || 6 + headerLength > bytes.byteLength) {
+        throw new ProtocolValidationError(`Invalid wire frame header length: ${headerLength}`, "headerLength");
+    }
+    const headerSlice = bytes.subarray(6, 6 + headerLength);
+    let header;
+    try {
+        header = JSON.parse(textDecoder.decode(headerSlice));
+    }
+    catch {
+        throw new ProtocolValidationError("Malformed JSON in wire frame header", "header");
+    }
+    if (typeof header !== "object" ||
+        header === null ||
+        typeof header.messageId !== "string" ||
+        typeof header.channel !== "string") {
+        throw new ProtocolValidationError("Wire frame header missing messageId or channel", "header");
+    }
+    const payload = bytes.subarray(6 + 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,45 @@
 {
   "name": "dropspace",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "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",
+  "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"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}
+