@droponair/sdk-js 0.3.1 → 0.5.0

package/dist/transport/protobuf-codec.js

@@ -42,9 +42,28 @@ const DeviceEncryptedPayloadType = new protobuf.Type('DeviceEncryptedPayload')
     .add(new protobuf.Field('deviceId', 1, 'string'))
     .add(new protobuf.Field('encryptedPayload', 2, 'bytes'))
     .add(new protobuf.Field('senderPublicKey', 3, 'bytes'));
+// Per-device wrapped file key for E2EE attachments (PROTOCOL_VERSION 4+)
+const DeviceWrappedKeyType = new protobuf.Type('DeviceWrappedKey')
+    .add(new protobuf.Field('deviceId', 1, 'string'))
+    .add(new protobuf.Field('wrappedKey', 2, 'bytes'))
+    .add(new protobuf.Field('senderPublicKey', 3, 'bytes'))
+    .add(new protobuf.Field('nonce', 4, 'bytes'));
+// Reference to an out-of-band attachment in customer-managed storage.
+const AttachmentRefEncTypeEnum = new protobuf.Enum('EncryptionType', { E2EE: 0, CLEARTEXT: 1 });
+const AttachmentRefType = new protobuf.Type('AttachmentRef')
+    .add(AttachmentRefEncTypeEnum)
+    .add(DeviceWrappedKeyType)
+    .add(new protobuf.Field('attachmentId', 1, 'string'))
+    .add(new protobuf.Field('storageHint', 2, 'string'))
+    .add(new protobuf.Field('mimeType', 3, 'string'))
+    .add(new protobuf.Field('sizeBytes', 4, 'int64'))
+    .add(new protobuf.Field('sha256', 5, 'string'))
+    .add(new protobuf.Field('encryptionType', 6, 'EncryptionType'))
+    .add(new protobuf.Field('wrappedKeys', 7, 'DeviceWrappedKey', 'repeated'));
 const EnvelopeType = new protobuf.Type('Envelope')
     .add(EncryptionTypeEnum)
     .add(DeviceEncryptedPayloadType) // nested type must be added first
+    .add(AttachmentRefType)
     .add(new protobuf.Field('messageId', 1, 'string'))
     .add(new protobuf.Field('appId', 2, 'string'))
     .add(new protobuf.Field('fromUserId', 3, 'string'))
@@ -55,7 +74,8 @@ const EnvelopeType = new protobuf.Type('Envelope')
     .add(new protobuf.Field('devicePayloads', 8, 'DeviceEncryptedPayload', 'repeated'))
     .add(new protobuf.Field('senderDeviceId', 9, 'string'))
     .add(new protobuf.Field('encryptionType', 10, 'EncryptionType'))
-    .add(new protobuf.Field('plaintextPayload', 11, 'string'));
+    .add(new protobuf.Field('plaintextPayload', 11, 'string'))
+    .add(new protobuf.Field('attachments', 12, 'AttachmentRef', 'repeated'));
 const AckType = new protobuf.Type('Ack')
     .add(new protobuf.Field('messageId', 1, 'string'))
     .add(new protobuf.Field('type', 2, 'string'));
@@ -104,6 +124,9 @@ const GroupMemberPayloadType = new protobuf.Type('GroupMemberPayload')
     .add(new protobuf.Field('userId', 1, 'string'))
     .add(new protobuf.Field('devicePayloads', 2, 'DeviceEncryptedPayload', 'repeated'));
 const GroupEnvelopeEncryptionTypeEnum = new protobuf.Enum('EncryptionType', { E2EE: 0, CLEARTEXT: 1 });
+// NOTE: GroupEnvelope JS field numbers diverge from the proto contract (tracked
+// under phase 2.3 "JS encrypted group send parity"). Attachments support for
+// groups in JS will land with phase 2.3 / 2.4 once field numbers are aligned.
 const GroupEnvelopeType = new protobuf.Type('GroupEnvelope')
     .add(GroupEnvelopeEncryptionTypeEnum)
     .add(GroupMemberPayloadType)
@@ -141,6 +164,47 @@ const GroupCallFrameType = new protobuf.Type('GroupCallFrame')
     .add(new protobuf.Field('groupId', 3, 'string'))
     .add(new protobuf.Field('targetUserId', 4, 'string'))
     .add(new protobuf.Field('payload', 5, 'string'));
+// ---------------------------------------------------------------------------
+// Message Edit and Delete (PROTOCOL_VERSION 3+)
+// ---------------------------------------------------------------------------
+//
+// E2EE invariant, server never sees plaintext for E2EE edits. The same frame
+// type is sent on the wire in both directions, client to server (request) and
+// server to recipient devices (notification).
+//
+// Type discriminator at field 1 mirrors the CallFrame pattern. Probed BEFORE
+// Envelope to avoid mis-routing.
+const MessageEditDeviceType = new protobuf.Type('DeviceEncryptedPayload')
+    .add(new protobuf.Field('deviceId', 1, 'string'))
+    .add(new protobuf.Field('encryptedPayload', 2, 'bytes'))
+    .add(new protobuf.Field('senderPublicKey', 3, 'bytes'));
+const MessageEditEncryptionTypeEnum = new protobuf.Enum('EncryptionType', { E2EE: 0, CLEARTEXT: 1 });
+const MessageEditFrameType = new protobuf.Type('MessageEditFrame')
+    .add(MessageEditEncryptionTypeEnum)
+    .add(MessageEditDeviceType)
+    .add(new protobuf.Field('type', 1, 'string'))
+    .add(new protobuf.Field('editId', 2, 'string'))
+    .add(new protobuf.Field('originalMessageId', 3, 'string'))
+    .add(new protobuf.Field('appId', 4, 'string'))
+    .add(new protobuf.Field('fromUserId', 5, 'string'))
+    .add(new protobuf.Field('toUserId', 6, 'string'))
+    .add(new protobuf.Field('timestamp', 7, 'int64'))
+    .add(new protobuf.Field('encryptionType', 8, 'EncryptionType'))
+    .add(new protobuf.Field('encryptedPayload', 9, 'bytes'))
+    .add(new protobuf.Field('devicePayloads', 10, 'DeviceEncryptedPayload', 'repeated'))
+    .add(new protobuf.Field('senderDeviceId', 11, 'string'))
+    .add(new protobuf.Field('plaintextPayload', 12, 'string'))
+    .add(new protobuf.Field('clientEditId', 13, 'string'));
+const MessageDeleteFrameType = new protobuf.Type('MessageDeleteFrame')
+    .add(new protobuf.Field('type', 1, 'string'))
+    .add(new protobuf.Field('deleteId', 2, 'string'))
+    .add(new protobuf.Field('originalMessageId', 3, 'string'))
+    .add(new protobuf.Field('appId', 4, 'string'))
+    .add(new protobuf.Field('fromUserId', 5, 'string'))
+    .add(new protobuf.Field('toUserId', 6, 'string'))
+    .add(new protobuf.Field('timestamp', 7, 'int64'))
+    .add(new protobuf.Field('scope', 8, 'string'))
+    .add(new protobuf.Field('clientDeleteId', 9, 'string'));
 class ProtobufCodec {
     encodeEnvelope(value) {
         return EnvelopeType.encode(value).finish();
@@ -163,7 +227,24 @@ class ProtobufCodec {
     encodeGroupAck(value) {
         return GroupAckType.encode(value).finish();
     }
+    encodeMessageEditFrame(value) {
+        return MessageEditFrameType.encode(value).finish();
+    }
+    encodeMessageDeleteFrame(value) {
+        return MessageDeleteFrameType.encode(value).finish();
+    }
     decodeFrame(payload) {
+        // Edit and delete frames must be probed BEFORE Envelope, the type
+        // discriminator at field 1 ("MESSAGE_EDIT" / "MESSAGE_DELETE") would
+        // otherwise parse as Envelope.messageId and could be mis-routed.
+        const asEdit = this.tryDecodeMessageEditFrame(payload);
+        if (asEdit) {
+            return { kind: 'messageEdit', data: asEdit };
+        }
+        const asDelete = this.tryDecodeMessageDeleteFrame(payload);
+        if (asDelete) {
+            return { kind: 'messageDelete', data: asDelete };
+        }
         const asEnvelope = this.tryDecodeEnvelope(payload);
         if (asEnvelope) {
             return { kind: 'envelope', data: asEnvelope };
@@ -231,6 +312,23 @@ class ProtobufCodec {
                     senderPublicKey: new Uint8Array(dp.senderPublicKey),
                 }));
             }
+            // Normalize attachments (PROTOCOL_VERSION 4+)
+            if (decoded.attachments && decoded.attachments.length > 0) {
+                result.attachments = decoded.attachments.map(att => ({
+                    attachmentId: att.attachmentId,
+                    storageHint: att.storageHint,
+                    mimeType: att.mimeType,
+                    sizeBytes: Number(att.sizeBytes),
+                    sha256: att.sha256,
+                    encryptionType: att.encryptionType ?? 0,
+                    wrappedKeys: att.wrappedKeys?.map(wk => ({
+                        deviceId: wk.deviceId,
+                        wrappedKey: new Uint8Array(wk.wrappedKey),
+                        senderPublicKey: new Uint8Array(wk.senderPublicKey),
+                        nonce: new Uint8Array(wk.nonce),
+                    })) ?? [],
+                }));
+            }
             return result;
         }
         catch {
@@ -333,5 +431,45 @@ class ProtobufCodec {
             return null;
         }
     }
+    tryDecodeMessageEditFrame(payload) {
+        try {
+            const decoded = MessageEditFrameType.decode(payload);
+            if (decoded.type !== 'MESSAGE_EDIT') {
+                return null;
+            }
+            const result = {
+                ...decoded,
+                timestamp: Number(decoded.timestamp),
+                encryptedPayload: decoded.encryptedPayload && decoded.encryptedPayload.length > 0
+                    ? new Uint8Array(decoded.encryptedPayload) : undefined,
+            };
+            if (decoded.devicePayloads && decoded.devicePayloads.length > 0) {
+                result.devicePayloads = decoded.devicePayloads.map(dp => ({
+                    deviceId: dp.deviceId,
+                    encryptedPayload: new Uint8Array(dp.encryptedPayload),
+                    senderPublicKey: new Uint8Array(dp.senderPublicKey),
+                }));
+            }
+            return result;
+        }
+        catch {
+            return null;
+        }
+    }
+    tryDecodeMessageDeleteFrame(payload) {
+        try {
+            const decoded = MessageDeleteFrameType.decode(payload);
+            if (decoded.type !== 'MESSAGE_DELETE') {
+                return null;
+            }
+            return {
+                ...decoded,
+                timestamp: Number(decoded.timestamp),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
 }
 exports.ProtobufCodec = ProtobufCodec;

package/dist/version.d.ts

@@ -7,7 +7,7 @@
  *   MINOR, additive feature (e.g. multi-device payloads, new call event type)
  *   PATCH, bug-fix / perf improvement with no wire or API change
  */
-export declare const SDK_VERSION = "0.3.1";
+export declare const SDK_VERSION = "0.5.0";
 /**
  * Binary encrypted-payload format version.
  * Included as the first byte of every encrypted payload so receivers can
@@ -19,4 +19,4 @@ export declare const PAYLOAD_FORMAT_VERSION = 1;
  * Increment when adding required proto fields or changing frame semantics.
  * The server advertises its supported range via GET /api/info.
  */
-export declare const PROTOCOL_VERSION = 2;
+export declare const PROTOCOL_VERSION = 4;

package/dist/version.js

@@ -10,7 +10,7 @@ exports.PROTOCOL_VERSION = exports.PAYLOAD_FORMAT_VERSION = exports.SDK_VERSION
  *   MINOR, additive feature (e.g. multi-device payloads, new call event type)
  *   PATCH, bug-fix / perf improvement with no wire or API change
  */
-exports.SDK_VERSION = '0.3.1';
+exports.SDK_VERSION = '0.5.0';
 /**
  * Binary encrypted-payload format version.
  * Included as the first byte of every encrypted payload so receivers can
@@ -22,4 +22,4 @@ exports.PAYLOAD_FORMAT_VERSION = 1;
  * Increment when adding required proto fields or changing frame semantics.
  * The server advertises its supported range via GET /api/info.
  */
-exports.PROTOCOL_VERSION = 2;
+exports.PROTOCOL_VERSION = 4;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@droponair/sdk-js",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "DropOnAir SDK for end-to-end encrypted messaging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",