@homebridge-eufy-security/eufy-security-client 3.7.2-dev.0

package/build/push/parser.js

@@ -0,0 +1,231 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PushClientParser = void 0;
+const path = __importStar(require("path"));
+const protobufjs_1 = require("protobufjs");
+const tiny_typed_emitter_1 = require("tiny-typed-emitter");
+const models_1 = require("./models");
+const error_1 = require("../error");
+const error_2 = require("./error");
+const logging_1 = require("../logging");
+class PushClientParser extends tiny_typed_emitter_1.TypedEmitter {
+    static proto = null;
+    state = models_1.ProcessingState.MCS_VERSION_TAG_AND_SIZE;
+    data = Buffer.alloc(0);
+    isWaitingForData = true;
+    sizePacketSoFar = 0;
+    messageSize = 0;
+    messageTag = 0;
+    handshakeComplete = false;
+    constructor() {
+        super();
+    }
+    resetState() {
+        this.state = models_1.ProcessingState.MCS_VERSION_TAG_AND_SIZE;
+        this.data = Buffer.alloc(0);
+        this.isWaitingForData = true;
+        this.sizePacketSoFar = 0;
+        this.messageSize = 0;
+        this.messageTag = 0;
+        this.handshakeComplete = false;
+        this.removeAllListeners();
+    }
+    static async init() {
+        this.proto = await (0, protobufjs_1.load)(path.join(__dirname, "./proto/mcs.proto"));
+        return new PushClientParser();
+    }
+    handleData(newData) {
+        this.data = Buffer.concat([this.data, newData]);
+        if (this.isWaitingForData) {
+            this.isWaitingForData = false;
+            this.waitForData();
+        }
+    }
+    waitForData() {
+        const minBytesNeeded = this.getMinBytesNeeded();
+        // If we don't have all bytes yet, wait some more
+        if (this.data.length < minBytesNeeded) {
+            this.isWaitingForData = true;
+            return;
+        }
+        else {
+            this.handleFullMessage();
+        }
+    }
+    handleFullMessage() {
+        switch (this.state) {
+            case models_1.ProcessingState.MCS_VERSION_TAG_AND_SIZE:
+                this.onGotVersion();
+                break;
+            case models_1.ProcessingState.MCS_TAG_AND_SIZE:
+                this.onGotMessageTag();
+                break;
+            case models_1.ProcessingState.MCS_SIZE:
+                this.onGotMessageSize();
+                break;
+            case models_1.ProcessingState.MCS_PROTO_BYTES:
+                this.onGotMessageBytes();
+                break;
+            default:
+                logging_1.rootPushLogger.warn("Push Parser - Unknown state", { state: this.state });
+                break;
+        }
+    }
+    onGotVersion() {
+        const version = this.data.readInt8(0);
+        this.data = this.data.subarray(1);
+        if (version < 41 && version !== 38) {
+            throw new error_2.MCSProtocolVersionError("Got wrong protocol version", { context: { version: version } });
+        }
+        // Process the LoginResponse message tag.
+        this.onGotMessageTag();
+    }
+    onGotMessageTag() {
+        this.messageTag = this.data.readInt8(0);
+        this.data = this.data.subarray(1);
+        this.onGotMessageSize();
+    }
+    onGotMessageSize() {
+        let incompleteSizePacket = false;
+        const reader = new protobufjs_1.BufferReader(this.data);
+        try {
+            this.messageSize = reader.int32();
+        }
+        catch (err) {
+            const error = (0, error_1.ensureError)(err);
+            if (error instanceof Error && error.message.startsWith("index out of range:")) {
+                incompleteSizePacket = true;
+            }
+            else {
+                throw error;
+            }
+        }
+        if (incompleteSizePacket) {
+            this.sizePacketSoFar = reader.pos;
+            this.state = models_1.ProcessingState.MCS_SIZE;
+            this.waitForData();
+            return;
+        }
+        this.data = this.data.subarray(reader.pos);
+        this.sizePacketSoFar = 0;
+        if (this.messageSize > 0) {
+            this.state = models_1.ProcessingState.MCS_PROTO_BYTES;
+            this.waitForData();
+        }
+        else {
+            this.onGotMessageBytes();
+        }
+    }
+    onGotMessageBytes() {
+        const protobuf = this.buildProtobufFromTag(this.messageTag);
+        if (this.messageSize === 0) {
+            this.emit("message", { tag: this.messageTag, object: {} });
+            this.getNextMessage();
+            return;
+        }
+        if (this.data.length < this.messageSize) {
+            this.state = models_1.ProcessingState.MCS_PROTO_BYTES;
+            this.waitForData();
+            return;
+        }
+        const buffer = this.data.subarray(0, this.messageSize);
+        this.data = this.data.subarray(this.messageSize);
+        const message = protobuf.decode(buffer);
+        const object = protobuf.toObject(message, {
+            longs: String,
+            enums: String,
+            bytes: Buffer,
+        });
+        this.emit("message", { tag: this.messageTag, object: object });
+        if (this.messageTag === models_1.MessageTag.LoginResponse) {
+            if (this.handshakeComplete) {
+                logging_1.rootPushLogger.error("Push Parser - Unexpected login response!");
+            }
+            else {
+                this.handshakeComplete = true;
+            }
+        }
+        this.getNextMessage();
+    }
+    getNextMessage() {
+        this.messageTag = 0;
+        this.messageSize = 0;
+        this.state = models_1.ProcessingState.MCS_TAG_AND_SIZE;
+        this.waitForData();
+    }
+    getMinBytesNeeded() {
+        switch (this.state) {
+            case models_1.ProcessingState.MCS_VERSION_TAG_AND_SIZE:
+                return 1 + 1 + 1;
+            case models_1.ProcessingState.MCS_TAG_AND_SIZE:
+                return 1 + 1;
+            case models_1.ProcessingState.MCS_SIZE:
+                return this.sizePacketSoFar + 1;
+            case models_1.ProcessingState.MCS_PROTO_BYTES:
+                return this.messageSize;
+            default:
+                throw new error_2.MCSProtocolProcessingStateError("Unknown protocol processing state", {
+                    context: { state: this.state },
+                });
+        }
+    }
+    buildProtobufFromTag(messageTag) {
+        switch (messageTag) {
+            case models_1.MessageTag.HeartbeatPing:
+                return PushClientParser.proto.lookupType("mcs_proto.HeartbeatPing");
+            case models_1.MessageTag.HeartbeatAck:
+                return PushClientParser.proto.lookupType("mcs_proto.HeartbeatAck");
+            case models_1.MessageTag.LoginRequest:
+                return PushClientParser.proto.lookupType("mcs_proto.LoginRequest");
+            case models_1.MessageTag.LoginResponse:
+                return PushClientParser.proto.lookupType("mcs_proto.LoginResponse");
+            case models_1.MessageTag.Close:
+                return PushClientParser.proto.lookupType("mcs_proto.Close");
+            case models_1.MessageTag.IqStanza:
+                return PushClientParser.proto.lookupType("mcs_proto.IqStanza");
+            case models_1.MessageTag.DataMessageStanza:
+                return PushClientParser.proto.lookupType("mcs_proto.DataMessageStanza");
+            case models_1.MessageTag.StreamErrorStanza:
+                return PushClientParser.proto.lookupType("mcs_proto.StreamErrorStanza");
+            default:
+                throw new error_2.MCSProtocolMessageTagError("Unknown protocol message tag", {
+                    context: { messageTag: this.messageTag },
+                });
+        }
+    }
+}
+exports.PushClientParser = PushClientParser;
+//# sourceMappingURL=parser.js.map

package/build/push/parser.js.map

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

package/build/push/proto/checkin.proto

@@ -0,0 +1,266 @@
+// Sample data, if provided, is fished from a Nexus 7 (2013) / flo running Android 5.0
+message CheckinRequest {
+    // unused
+    optional string imei = 1;
+
+    // Gservices["android_id"] or 0 on first-checkin
+    optional int64 androidId = 2;
+
+    // Gservices["digest"] or ""
+    optional string digest = 3;
+
+    required Checkin checkin = 4;
+    message Checkin {
+        // empty Build on pre-checkin
+        required Build build = 1;
+        message Build {
+            // Build.FINGERPRINT
+            // eg. google/razor/flo:5.0.1/LRX22C/1602158:user/release-keys
+            optional string fingerprint = 1;
+
+            // Build.HARDWARE
+            // eg. flo
+            optional string hardware = 2;
+
+            // Build.BRAND
+            // eg. google
+            optional string brand = 3;
+
+            // Build.getRadioVersion()
+            optional string radio = 4;
+
+            // Build.BOOTLOADER
+            // eg. FLO-04.04
+            optional string bootloader = 5;
+
+            // GoogleSettingsContract.Partner["client_id"]
+            // eg. android-google
+            optional string clientId = 6;
+
+            // Build.TIME / 1000L
+            // eg. 1416533192
+            optional int64 time = 7;
+
+            // PackageInfo.versionCode
+            // eg. 6188736
+            optional int32 packageVersionCode = 8;
+
+            // Build.DEVICE
+            // eg. flo
+            optional string device = 9;
+
+            // Build.VERSION.SDK_INT
+            // eg. 21
+            optional int32 sdkVersion = 10;
+
+            // Build.MODEL
+            // eg. Nexus 7
+            optional string model = 11;
+
+            // Build.MANUFACTURER
+            // eg. asus
+            optional string manufacturer = 12;
+
+            // Build.PRODUCT
+            // eg. razor
+            optional string product = 13;
+
+            // fileExists("/system/recovery-from-boot.p")
+            // eg. false
+            optional bool otaInstalled = 14;
+        }
+
+        // last checkin ms or 0 if first checkin
+        // eg. 0
+        optional int64 lastCheckinMs = 2;
+
+        // eg. ("event_log_start",~,1424612602652) on first checkin
+        repeated Event event = 3;
+        message Event {
+            optional string tag = 1;
+            optional string value = 2;
+            optional int64 timeMs = 3;
+        }
+
+        // unknown, n/a on first checkin
+        repeated Statistic stat = 4;
+        message Statistic {
+            required string tag = 1;
+            optional int32 count = 2;
+            optional float sum = 3;
+        }
+
+        // unused
+        repeated string requestedGroup = 5;
+
+        // TelephonyManager.getNetworkOperator != null|empty
+        optional string cellOperator = 6;
+
+        // TelephonyManager.getSimOperator != null|empty
+        optional string simOperator = 7;
+
+        // "WIFI::" | ("mobile" | "notmobile" | "unknown") + "-" + ("roaming" | "notroaming" | "unknown")
+        optional string roaming = 8;
+
+        // UserHandle.myUserId
+        // eg. 0
+        optional int32 userNumber = 9;
+    }
+
+    // unused
+    optional string desiredBuild = 5;
+
+    // Locale.toString
+    optional string locale = 6;
+
+    // GoogleSettingsContract.Partner["logging_id2"] (choosen randomly on first checkin)
+    // eg. 12561488293572742346
+    optional int64 loggingId = 7;
+
+    // unused
+    optional string marketCheckin = 8;
+
+    // NetworkInfo.getExtraInfo, WifiInfo.getMacAddress (12 hex-digits)
+    // eg. d850e6abcdef
+    repeated string macAddress = 9;
+
+    // TelephonyManager.getDeviceId (14 hex-digits), not set on tablets
+    optional string meid = 10;
+
+    // "[<email>]" followed by "<authToken>", empty string on first checkin
+    repeated string accountCookie = 11;
+
+    // TimeZone.getId
+    // eg. GMT
+    optional string timeZone = 12;
+
+    // security token as given on first checkin, not set on first checkin
+    optional fixed64 securityToken = 13;
+
+    // use 3
+    optional int32 version = 14;
+
+    // SHA-1 of each in /system/etc/security/otacerts.zip or "--IOException--" or "--no-output--"
+    // eg. dKXTm1QH9QShGQwBM/4rg6/lCNQ=
+    repeated string otaCert = 15;
+
+    // Build.SERIAL != "unknown"
+    // eg. 07d90b18
+    optional string serial = 16;
+
+    // TelephonyManager.getDeviceId (8 hex-digits), not set on tablets
+    optional string esn = 17;
+
+    optional DeviceConfig deviceConfiguration = 18;
+    message DeviceConfig {
+        // ConfigurationInfo.reqTouchScreen
+        // eg. 3
+        optional int32 touchScreen = 1;
+
+        // ConfigurationInfo.reqKeyboardType
+        // eg. 1
+        optional int32 keyboardType = 2;
+
+        // ConfigurationInfo.reqNavigation
+        // eg. 1
+        optional int32 navigation = 3;
+        // ConfigurationInfo.screenLayout
+        // eg. 3
+        optional int32 screenLayout = 4;
+
+        // ConfigurationInfo.reqInputFeatures & ConfigurationInfo.INPUT_FEATURE_HARD_KEYBOARD
+        // eg. 0
+        optional bool hasHardKeyboard = 5;
+
+        // ConfigurationInfo.reqInputFeatures & ConfigurationInfo.INPUT_FEATURE_FIVE_WAY_NAV
+        // eg. 0
+        optional bool hasFiveWayNavigation = 6;
+
+        // DisplayMetrics.densityDpi
+        // eg. 320
+        optional int32 densityDpi = 7;
+
+        // ConfigurationInfo.reqGlEsVersion
+        // eg. 196608
+        optional int32 glEsVersion = 8;
+
+        // PackageManager.getSystemSharedLibraryNames
+        // eg. "android.test.runner", "com.android.future.usb.accessory", "com.android.location.provider",
+        //     "com.android.media.remotedisplay", "com.android.mediadrm.signer", "com.google.android.maps",
+        //     "com.google.android.media.effects", "com.google.widevine.software.drm", "javax.obex"
+        repeated string sharedLibrary = 9;
+
+        // PackageManager.getSystemAvailableFeatures
+        // eg. android.hardware.[...]
+        repeated string availableFeature = 10;
+
+        // Build.CPU_ABI and Build.CPU_ABI2 != "unknown"
+        // eg. "armeabi-v7a", "armeabi"
+        repeated string nativePlatform = 11;
+
+        // DisplayMetrics.widthPixels
+        // eg. 1200
+        optional int32 widthPixels = 12;
+
+        // DisplayMetrics.heightPixels
+        // eg. 1824
+        optional int32 heightPixels = 13;
+
+        // Context.getAssets.getLocales
+        // eg. [...], "en-US", [...]
+        repeated string locale = 14;
+
+        // GLES10.glGetString(GLES10.GL_EXTENSIONS)
+        // eg. "GL_AMD_compressed_ATC_texture", [...]
+        repeated string glExtension = 15;
+
+        // unused
+        optional int32 deviceClass = 16;
+        // unused
+        optional int32 maxApkDownloadSizeMb = 17;
+    }
+
+    // "ethernet" or "wifi"
+    repeated string macAddressType = 19;
+
+    // unknown, use 0 on pre- and first-checkin, and 1 for later checkins
+    // also present on pre-checkin
+    required int32 fragment = 20;
+
+    // unknown
+    optional string userName = 21;
+
+    // UserManager.getUserSerialNumber
+    // eg. 0
+    optional int32 userSerialNumber = 22;
+}
+
+message CheckinResponse {
+    optional bool statsOk = 1;
+    repeated Intent intent = 2;
+    message Intent {
+        optional string action = 1;
+        optional string dataUri = 2;
+        optional string mimeType = 3;
+        optional string javaClass = 4;
+        repeated Extra extra = 5;
+        message Extra {
+            optional string name = 6;
+            optional string value = 7;
+        }
+    }
+    optional int64 timeMs = 3;
+    optional string digest = 4;
+    repeated GservicesSetting setting = 5;
+    message GservicesSetting {
+        optional bytes name = 1;
+        optional bytes value = 2;
+    }
+    optional bool marketOk = 6;
+    optional fixed64 androidId = 7;
+    optional fixed64 securityToken = 8;
+    optional bool settingsDiff = 9;
+    repeated string deleteSetting = 10;
+    optional string versionInfo = 11;
+    optional string deviceDataVersionInfo = 12;
+}