shadowx-fca 8.0.0

package/src/e2ee/proto/ConsumerApplication.proto

@@ -0,0 +1,232 @@
+syntax = "proto2";
+package waConsumerApplication;
+
+import "WACommon.proto";
+
+message ConsumerApplication {
+	message Payload {
+		oneof payload {
+			Content content = 1;
+			ApplicationData applicationData = 2;
+			Signal signal = 3;
+			SubProtocolPayload subProtocol = 4;
+		}
+	}
+
+	message SubProtocolPayload {
+		optional WACommon.FutureProofBehavior futureProof = 1;
+	}
+
+	message Metadata {
+		enum SpecialTextSize {
+			SMALL = 1;
+			MEDIUM = 2;
+			LARGE = 3;
+		}
+
+		optional SpecialTextSize specialTextSize = 1;
+	}
+
+	message Signal {
+	}
+
+	message ApplicationData {
+		oneof applicationContent {
+			RevokeMessage revoke = 1;
+		}
+	}
+
+	message Content {
+		oneof content {
+			WACommon.MessageText messageText = 1;
+			ImageMessage imageMessage = 2;
+			ContactMessage contactMessage = 3;
+			LocationMessage locationMessage = 4;
+			ExtendedTextMessage extendedTextMessage = 5;
+			StatusTextMesage statusTextMessage = 6;
+			DocumentMessage documentMessage = 7;
+			AudioMessage audioMessage = 8;
+			VideoMessage videoMessage = 9;
+			ContactsArrayMessage contactsArrayMessage = 10;
+			LiveLocationMessage liveLocationMessage = 11;
+			StickerMessage stickerMessage = 12;
+			GroupInviteMessage groupInviteMessage = 13;
+			ViewOnceMessage viewOnceMessage = 14;
+			ReactionMessage reactionMessage = 16;
+			PollCreationMessage pollCreationMessage = 17;
+			PollUpdateMessage pollUpdateMessage = 18;
+			EditMessage editMessage = 19;
+		}
+	}
+
+	message EditMessage {
+		optional WACommon.MessageKey key = 1;
+		optional WACommon.MessageText message = 2;
+		optional int64 timestampMS = 3;
+	}
+
+	message PollAddOptionMessage {
+		repeated Option pollOption = 1;
+	}
+
+	message PollVoteMessage {
+		repeated bytes selectedOptions = 1;
+		optional int64 senderTimestampMS = 2;
+	}
+
+	message PollEncValue {
+		optional bytes encPayload = 1;
+		optional bytes encIV = 2;
+	}
+
+	message PollUpdateMessage {
+		optional WACommon.MessageKey pollCreationMessageKey = 1;
+		optional PollEncValue vote = 2;
+		optional PollEncValue addOption = 3;
+	}
+
+	message PollCreationMessage {
+		optional bytes encKey = 1;
+		optional string name = 2;
+		repeated Option options = 3;
+		optional uint32 selectableOptionsCount = 4;
+	}
+
+	message Option {
+		optional string optionName = 1;
+	}
+
+	message ReactionMessage {
+		optional WACommon.MessageKey key = 1;
+		optional string text = 2;
+		optional string groupingKey = 3;
+		optional int64 senderTimestampMS = 4;
+		optional string reactionMetadataDataclassData = 5;
+		optional int32 style = 6;
+	}
+
+	message RevokeMessage {
+		optional WACommon.MessageKey key = 1;
+	}
+
+	message ViewOnceMessage {
+		oneof viewOnceContent {
+			ImageMessage imageMessage = 1;
+			VideoMessage videoMessage = 2;
+		}
+	}
+
+	message GroupInviteMessage {
+		optional string groupJID = 1;
+		optional string inviteCode = 2;
+		optional int64 inviteExpiration = 3;
+		optional string groupName = 4;
+		optional bytes JPEGThumbnail = 5;
+		optional WACommon.MessageText caption = 6;
+	}
+
+	message LiveLocationMessage {
+		optional Location location = 1;
+		optional uint32 accuracyInMeters = 2;
+		optional float speedInMps = 3;
+		optional uint32 degreesClockwiseFromMagneticNorth = 4;
+		optional WACommon.MessageText caption = 5;
+		optional int64 sequenceNumber = 6;
+		optional uint32 timeOffset = 7;
+	}
+
+	message ContactsArrayMessage {
+		optional string displayName = 1;
+		repeated ContactMessage contacts = 2;
+	}
+
+	message ContactMessage {
+		optional WACommon.SubProtocol contact = 1;
+	}
+
+	message StatusTextMesage {
+		enum FontType {
+			SANS_SERIF = 0;
+			SERIF = 1;
+			NORICAN_REGULAR = 2;
+			BRYNDAN_WRITE = 3;
+			BEBASNEUE_REGULAR = 4;
+			OSWALD_HEAVY = 5;
+		}
+
+		optional ExtendedTextMessage text = 1;
+		optional fixed32 textArgb = 6;
+		optional fixed32 backgroundArgb = 7;
+		optional FontType font = 8;
+	}
+
+	message ExtendedTextMessage {
+		enum PreviewType {
+			NONE = 0;
+			VIDEO = 1;
+		}
+
+		optional WACommon.MessageText text = 1;
+		optional string matchedText = 2;
+		optional string canonicalURL = 3;
+		optional string description = 4;
+		optional string title = 5;
+		optional WACommon.SubProtocol thumbnail = 6;
+		optional PreviewType previewType = 7;
+	}
+
+	message LocationMessage {
+		optional Location location = 1;
+		optional string address = 2;
+	}
+
+	message StickerMessage {
+		optional WACommon.SubProtocol sticker = 1;
+	}
+
+	message DocumentMessage {
+		optional WACommon.SubProtocol document = 1;
+		optional string fileName = 2;
+	}
+
+	message VideoMessage {
+		optional WACommon.SubProtocol video = 1;
+		optional WACommon.MessageText caption = 2;
+	}
+
+	message AudioMessage {
+		optional WACommon.SubProtocol audio = 1;
+		optional bool PTT = 2;
+	}
+
+	message ImageMessage {
+		optional WACommon.SubProtocol image = 1;
+		optional WACommon.MessageText caption = 2;
+	}
+
+	message InteractiveAnnotation {
+		oneof action {
+			Location location = 2;
+		}
+
+		repeated Point polygonVertices = 1;
+	}
+
+	message Point {
+		optional double x = 1;
+		optional double y = 2;
+	}
+
+	message Location {
+		optional double degreesLatitude = 1;
+		optional double degreesLongitude = 2;
+		optional string name = 3;
+	}
+
+	message MediaPayload {
+		optional WACommon.SubProtocol protocol = 1;
+	}
+
+	optional Payload payload = 1;
+	optional Metadata metadata = 2;
+}

package/src/e2ee/proto/MessageApplication.proto

@@ -0,0 +1,82 @@
+syntax = "proto2";
+package WAMsgApplication;
+
+import "WACommon.proto";
+
+message MessageApplication {
+	message Metadata {
+		enum ThreadType {
+			DEFAULT = 0;
+			VANISH_MODE = 1;
+			DISAPPEARING_MESSAGES = 2;
+		}
+
+		message QuotedMessage {
+			optional string stanzaID = 1;
+			optional string remoteJID = 2;
+			optional string participant = 3;
+			optional Payload payload = 4;
+		}
+
+		message EphemeralSetting {
+			enum EphemeralityType {
+				UNKNOWN = 0;
+				SEEN_ONCE = 1;
+				SEEN_BASED_WITH_TIMER = 2;
+				SEND_BASED_WITH_TIMER = 3;
+			}
+
+			optional uint32 ephemeralExpiration = 2;
+			optional int64 ephemeralSettingTimestamp = 3;
+			optional EphemeralityType ephemeralityType = 5;
+			optional bool isEphemeralSettingReset = 4;
+		}
+
+		message EphemeralSettingMap {
+			optional string chatJID = 1;
+			optional EphemeralSetting ephemeralSetting = 2;
+		}
+
+		oneof ephemeral {
+			EphemeralSetting chatEphemeralSetting = 1;
+			EphemeralSettingMap ephemeralSettingList = 2;
+			bytes ephemeralSharedSecret = 3;
+		}
+
+		optional uint32 forwardingScore = 5;
+		optional bool isForwarded = 6;
+		optional WACommon.SubProtocol businessMetadata = 7;
+		optional bytes frankingKey = 8;
+		optional int32 frankingVersion = 9;
+		optional QuotedMessage quotedMessage = 10;
+		optional ThreadType threadType = 11;
+		optional string readonlyMetadataDataclass = 12;
+		optional string groupID = 13;
+		optional uint32 groupSize = 14;
+		optional uint32 groupIndex = 15;
+		optional string botResponseID = 16;
+		optional string collapsibleID = 17;
+		optional string secondaryOtid = 18;
+	}
+
+	message Payload {
+		oneof content {
+			SubProtocolPayload subProtocol = 4;
+		}
+	}
+
+	message SubProtocolPayload {
+		oneof subProtocol {
+			WACommon.SubProtocol consumerMessage = 2;
+			WACommon.SubProtocol businessMessage = 3;
+			WACommon.SubProtocol paymentMessage = 4;
+			WACommon.SubProtocol multiDevice = 5;
+			WACommon.SubProtocol voip = 6;
+			WACommon.SubProtocol armadillo = 7;
+		}
+		optional WACommon.FutureProofBehavior futureProof = 1;
+	}
+
+	optional Payload payload = 1;
+	optional Metadata metadata = 2;
+}

package/src/e2ee/proto/MessageTransport.proto

@@ -0,0 +1,77 @@
+syntax = "proto2";
+package waMsgTransport;
+
+message MessageTransport {
+  message Payload {
+    message SubProtocol {
+      optional bytes payload = 1;
+      optional int32 version = 2;
+    }
+
+    optional SubProtocol applicationPayload = 1;
+    optional int32 futureProof = 3;
+  }
+
+  message Protocol {
+    message Integral {
+      message DeviceSentMessage {
+        optional string destinationJID = 1;
+        optional string phash = 2;
+      }
+
+      optional bytes padding = 1;
+      optional DeviceSentMessage DSM = 2;
+    }
+
+    message Ancillary {
+      message SenderKeyDistributionMessage {
+        optional string groupID = 1;
+        optional bytes axolotlSenderKeyDistributionMessage = 2;
+      }
+
+      message DeviceListMetadata {
+        optional bytes senderKeyHash = 1;
+        optional uint64 senderTimestamp = 2;
+        optional bytes recipientKeyHash = 8;
+        optional uint64 recipientTimestamp = 9;
+      }
+
+      message ICDCParticipantDevices {
+        message ICDCIdentityListDescription {
+          optional int32 seq = 1;
+          optional bytes signingDevice = 2;
+          repeated bytes unknownDevices = 3;
+          repeated int32 unknownDeviceIDs = 4;
+        }
+
+        optional ICDCIdentityListDescription senderIdentity = 1;
+        repeated ICDCIdentityListDescription recipientIdentities = 2;
+        repeated string recipientUserJIDs = 3;
+      }
+
+      message BackupDirective {
+        enum ActionType {
+          NOOP = 0;
+          UPSERT = 1;
+          DELETE = 2;
+          UPSERT_AND_DELETE = 3;
+        }
+
+        optional string messageID = 1;
+        optional ActionType actionType = 2;
+        optional string supplementalKey = 3;
+      }
+
+      optional SenderKeyDistributionMessage skdm = 2;
+      optional DeviceListMetadata deviceListMetadata = 3;
+      optional ICDCParticipantDevices icdc = 4;
+      optional BackupDirective backupDirective = 5;
+    }
+
+    optional Integral integral = 1;
+    optional Ancillary ancillary = 2;
+  }
+
+  optional Payload payload = 1;
+  optional Protocol protocol = 2;
+}

package/src/e2ee/proto/WACommon.proto

@@ -0,0 +1,66 @@
+syntax = "proto2";
+package WACommon;
+
+enum FutureProofBehavior {
+	PLACEHOLDER = 0;
+	NO_PLACEHOLDER = 1;
+	IGNORE = 2;
+}
+
+message MessageKey {
+	optional string remoteJID = 1;
+	optional bool fromMe = 2;
+	optional string ID = 3;
+	optional string participant = 4;
+}
+
+message Command {
+	enum CommandType {
+		EVERYONE = 1;
+		SILENT = 2;
+		AI = 3;
+		AI_IMAGINE = 4;
+	}
+
+	optional CommandType commandType = 1;
+	optional uint32 offset = 2;
+	optional uint32 length = 3;
+	optional string validationToken = 4;
+}
+
+message Mention {
+	enum MentionType {
+		PROFILE = 0;
+	}
+
+	optional MentionType mentionType = 1;
+	optional string mentionedJID = 2;
+	optional uint32 offset = 3;
+	optional uint32 length = 4;
+}
+
+message MessageText {
+	optional string text = 1;
+	repeated string mentionedJID = 2;
+	repeated Command commands = 3;
+	repeated Mention mentions = 4;
+}
+
+message SubProtocol {
+	optional bytes payload = 1;
+	optional int32 version = 2;
+}
+
+message LimitSharing {
+	enum Trigger {
+		UNKNOWN = 0;
+		CHAT_SETTING = 1;
+		BIZ_SUPPORTS_FB_HOSTING = 2;
+		UNKNOWN_GROUP = 3;
+	}
+
+	optional bool sharingLimited = 1;
+	optional Trigger trigger = 2;
+	optional int64 limitSharingSettingTimestamp = 3;
+	optional bool initiatedByMe = 4;
+}

package/src/e2ee/proto/WAMediaTransport.proto

@@ -0,0 +1,176 @@
+syntax = "proto2";
+package WAMediaTransport;
+
+import "WACommon.proto";
+
+message WAMediaTransport {
+  message Ancillary {
+    message Thumbnail {
+      message DownloadableThumbnail {
+        optional bytes fileSHA256 = 1;
+        optional bytes fileEncSHA256 = 2;
+        optional string directPath = 3;
+        optional bytes mediaKey = 4;
+        optional int64 mediaKeyTimestamp = 5;
+        optional string objectID = 6;
+        optional bytes thumbnailScansSidecar = 7;
+        repeated uint32 thumbnailScanLengths = 8;
+      }
+
+      optional bytes JPEGThumbnail = 1;
+      optional DownloadableThumbnail downloadableThumbnail = 2;
+      optional uint32 thumbnailWidth = 3;
+      optional uint32 thumbnailHeight = 4;
+    }
+
+    optional uint64 fileLength = 1;
+    optional string mimetype = 2;
+    optional Thumbnail thumbnail = 3;
+    optional string objectID = 4;
+  }
+
+  message Integral {
+    optional bytes fileSHA256 = 1;
+    optional bytes mediaKey = 2;
+    optional bytes fileEncSHA256 = 3;
+    optional string directPath = 4;
+    optional int64 mediaKeyTimestamp = 5;
+  }
+
+  optional Integral integral = 1;
+  optional Ancillary ancillary = 2;
+}
+
+message ImageTransport {
+  message Ancillary {
+    enum HdType {
+      NONE = 0;
+      LQ_4K = 1;
+      HQ_4K = 2;
+    }
+
+    optional uint32 height = 1;
+    optional uint32 width = 2;
+    optional bytes scansSidecar = 3;
+    repeated uint32 scanLengths = 4;
+    optional bytes midQualityFileSHA256 = 5;
+    optional HdType hdType = 6;
+    repeated float memoriesConceptScores = 7 [packed=true];
+    repeated uint32 memoriesConceptIDs = 8 [packed=true];
+  }
+
+  message Integral {
+    optional WAMediaTransport transport = 1;
+  }
+
+  optional Integral integral = 1;
+  optional Ancillary ancillary = 2;
+}
+
+message VideoTransport {
+  message Ancillary {
+    enum Attribution {
+      NONE = 0;
+      GIPHY = 1;
+      TENOR = 2;
+    }
+
+    optional uint32 seconds = 1;
+    optional WACommon.MessageText caption = 2;
+    optional bool gifPlayback = 3;
+    optional uint32 height = 4;
+    optional uint32 width = 5;
+    optional bytes sidecar = 6;
+    optional Attribution gifAttribution = 7;
+    optional string accessibilityLabel = 8;
+    optional bool isHd = 9;
+  }
+
+  message Integral {
+    optional WAMediaTransport transport = 1;
+  }
+
+  optional Integral integral = 1;
+  optional Ancillary ancillary = 2;
+}
+
+message AudioTransport {
+  message Ancillary {
+    message AvatarAudio {
+      enum AnimationsType {
+        TALKING_A = 0;
+        IDLE_A = 1;
+        TALKING_B = 2;
+        IDLE_B = 3;
+        BACKGROUND = 4;
+      }
+
+      message DownloadableAvatarAnimations {
+        optional bytes fileSHA256 = 1;
+        optional bytes fileEncSHA256 = 2;
+        optional string directPath = 3;
+        optional bytes mediaKey = 4;
+        optional int64 mediaKeyTimestamp = 5;
+        optional string objectID = 6;
+        optional AnimationsType animationsType = 7;
+      }
+
+      optional uint32 poseID = 1;
+      repeated DownloadableAvatarAnimations avatarAnimations = 2;
+    }
+
+    optional uint32 seconds = 1;
+    optional AvatarAudio avatarAudio = 2;
+    optional string waveformData = 3;
+    optional bytes waveform = 4;
+  }
+
+  message Integral {
+    enum AudioFormat {
+      UNKNOWN = 0;
+      OPUS = 1;
+    }
+
+    optional WAMediaTransport transport = 1;
+    optional AudioFormat audioFormat = 2;
+  }
+
+  optional Integral integral = 1;
+  optional Ancillary ancillary = 2;
+}
+
+message DocumentTransport {
+  message Ancillary {
+    optional uint32 pageCount = 1;
+  }
+
+  message Integral {
+    optional WAMediaTransport transport = 1;
+  }
+
+  optional Integral integral = 1;
+  optional Ancillary ancillary = 2;
+}
+
+message StickerTransport {
+  message Ancillary {
+    optional uint32 pageCount = 1;
+    optional uint32 height = 2;
+    optional uint32 width = 3;
+    optional uint32 firstFrameLength = 4;
+    optional bytes firstFrameSidecar = 5;
+    optional string mustacheText = 6;
+    optional bool isThirdParty = 7;
+    optional string receiverFetchID = 8;
+    optional string accessibilityLabel = 9;
+  }
+
+  message Integral {
+    optional WAMediaTransport transport = 1;
+    optional bool isAnimated = 2;
+    optional string receiverFetchID = 3;
+  }
+
+  optional Integral integral = 1;
+  optional Ancillary ancillary = 2;
+}

package/src/e2ee/proto/proto-writer.ts

@@ -0,0 +1,76 @@
+/** Minimal protobuf writer - only what we need */
+export class ProtoWriter {
+  private chunks: Buffer[] = [];
+
+  private encodeVarint(value: number): Buffer {
+    const bytes: number[] = [];
+    let v = value >>> 0;
+    while (v > 127) {
+      bytes.push((v & 0x7f) | 0x80);
+      v >>>= 7;
+    }
+    bytes.push(v);
+    return Buffer.from(bytes);
+  }
+
+  private fieldHeader(fieldNum: number, wireType: number): Buffer {
+    return this.encodeVarint((fieldNum << 3) | wireType);
+  }
+
+  /** Wire type 0 (varint) but supports bigint */
+  private encodeVarintBigInt(value: bigint): Buffer {
+    const bytes: number[] = [];
+    let v = value;
+    while (v > 127n) {
+      bytes.push(Number((v & 0x7fn) | 0x80n));
+      v >>= 7n;
+    }
+    bytes.push(Number(v));
+    return Buffer.from(bytes);
+  }
+
+  /** Wire type 0 (varint) for uint64 fields */
+  uint64_varint(fieldNum: number, value: bigint): this {
+    this.chunks.push(this.fieldHeader(fieldNum, 0));
+    this.chunks.push(this.encodeVarintBigInt(value));
+    return this;
+  }
+
+  /** Wire type 2 (length-delimited) - bytes, string, embedded message */
+  bytes(fieldNum: number, data: Uint8Array): this {
+    const d = Buffer.from(data);
+    this.chunks.push(this.fieldHeader(fieldNum, 2));
+    this.chunks.push(this.encodeVarint(d.length));
+    this.chunks.push(d);
+    return this;
+  }
+
+  string(fieldNum: number, value: string): this {
+    return this.bytes(fieldNum, Buffer.from(value, "utf8"));
+  }
+
+  /** Wire type 0 (varint) */
+  varint(fieldNum: number, value: number): this {
+    this.chunks.push(this.fieldHeader(fieldNum, 0));
+    this.chunks.push(this.encodeVarint(value));
+    return this;
+  }
+
+  /** Wire type 0, bool */
+  bool(fieldNum: number, value: boolean): this {
+    return this.varint(fieldNum, value ? 1 : 0);
+  }
+
+  /** Wire type 1 (64-bit fixed) - uint64 */
+  uint64(fieldNum: number, value: bigint): this {
+    const buf = Buffer.alloc(8);
+    buf.writeBigUInt64LE(value);
+    this.chunks.push(this.fieldHeader(fieldNum, 1));
+    this.chunks.push(buf);
+    return this;
+  }
+
+  build(): Buffer {
+    return Buffer.concat(this.chunks);
+  }
+}