@tak-ps/node-cot 1.0.0

package/.eslintrc.json

@@ -0,0 +1,54 @@
+{
+    "extends": "eslint:recommended",
+    "root": true,
+    "env": {
+        "node": true
+    },
+    "globals": {
+        "Map": true,
+        "Promise": true,
+        "FormData": true,
+        "Blob": true
+    },
+    "parserOptions": {
+        "ecmaVersion": 13,
+        "sourceType": "module"
+    },
+    "plugins": [ "node" ],
+    "rules": {
+        "no-console": 0,
+        "arrow-parens": [ "error", "always" ],
+        "no-var": "error",
+        "prefer-const": "error",
+        "array-bracket-spacing": [ "error", "never" ],
+        "comma-dangle": [ "error", "never" ],
+        "computed-property-spacing": [ "error", "never" ],
+        "eol-last": "error",
+        "eqeqeq": [ "error", "smart" ],
+        "indent": [ "error", 4, { "SwitchCase": 1 } ],
+        "no-confusing-arrow": [ "error", { "allowParens": false } ],
+        "no-extend-native": "error",
+        "no-mixed-spaces-and-tabs": "error",
+        "func-call-spacing": [ "error", "never" ],
+        "no-trailing-spaces": "error",
+        "no-unused-vars": "error",
+        "no-use-before-define": [ "error", "nofunc" ],
+        "object-curly-spacing": [ "error", "always" ],
+        "prefer-arrow-callback": "error",
+        "quotes": [ "error", "single", "avoid-escape" ],
+        "semi": [ "error", "always" ],
+        "space-infix-ops": "error",
+        "spaced-comment": [ "error", "always" ],
+        "keyword-spacing": [ "error", { "before": true, "after": true } ],
+        "template-curly-spacing": [ "error", "never" ],
+        "semi-spacing": "error",
+        "strict": "error",
+        "node/no-missing-require": "error",
+        "valid-jsdoc": ["error", {
+            "requireParamDescription": false,
+            "requireReturnDescription": false,
+            "requireReturnType": false,
+            "requireReturn": false
+        }]
+    }
+}

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,16 @@
+on: push
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v1
+      - uses: actions/setup-node@v1
+        with:
+          node-version: 14
+      - run: npm install
+      - run: npm test
+      - uses: JS-DevTools/npm-publish@v1
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          access: "public"

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Vidterra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+<h1 align=center>node-CoT</h1>
+
+<p align=center>Javascript Cursor-On-Target Library</p>
+
+Lightweight JavaScript library for parsing and manipulating TAK messages, primarily Cursor-on-Target (COT)
+
+## About
+
+tak.js converts between TAK message protocols and a Javascript object/JSON format. This makes it easy to read and write TAK messages in a Node.js application.
+
+## Installation
+
+### NPM
+
+To install `node-cot` with npm run
+
+```bash
+npm install @tak-ps/node-cot
+```
+
+## Usage Examples
+
+### Basic Usage
+
+```
+import { cot } from '@tak-ps/node-cot';
+const message = '<event version="2.0" uid="ANDROID-deadbeef" type="a-f-G-U-C" how="m-g" time="2021-02-27T20:32:24.771Z" start="2021-02-27T20:32:24.771Z" stale="2021-02-27T20:38:39.771Z"><point lat="1.234567" lon="-3.141592" hae="-25.7" ce="9.9" le="9999999.0"/><detail><takv os="29" version="4.0.0.0 (deadbeef).1234567890-CIV" device="Some Android Device" platform="ATAK-CIV"/><contact xmppUsername="xmpp@host.com" endpoint="*:-1:stcp" callsign="JENNY"/><uid Droid="JENNY"/><precisionlocation altsrc="GPS" geopointsrc="GPS"/><__group role="Team Member" name="Cyan"/><status battery="78"/><track course="80.24833892285461" speed="0.0"/></detail></event>'
+const json = cot.xml2js(message)
+console.log(json)
+```

package/assets/contact.proto

@@ -0,0 +1,14 @@
+syntax = "proto3";
+option optimize_for = LITE_RUNTIME;
+
+package atakmap.commoncommo.protobuf.v1;
+
+// All items are required unless otherwise noted!
+// "required" means if they are missing on send, the conversion
+// to the message format will be rejected and fall back to opaque
+// XML representation
+message Contact {
+     // Endpoint is optional; if missing/empty do not populate.
+     string endpoint = 1;           // endpoint=
+     string callsign = 2;           // callsign=
+}

package/assets/cotevent.proto

@@ -0,0 +1,45 @@
+
+syntax = "proto3";
+
+option optimize_for = LITE_RUNTIME;
+
+package atakmap.commoncommo.protobuf.v1;
+
+import "detail.proto";
+
+// A note about timestamps:
+// Uses "timeMs" units, which is number of milliseconds since
+// 1970-01-01 00:00:00 UTC
+//
+// All items are required unless otherwise noted!
+// "required" means if they are missing in the XML during outbound
+// conversion to protobuf, the message will be
+// rejected
+message CotEvent {
+    // <event>
+
+    string type = 1;               // <event type="x">
+
+    string access = 2;             // optional
+    string qos = 3;                // optional
+    string opex = 4;               // optional
+
+    string uid = 5;                // <event uid="x">
+    uint64 sendTime = 6;           // <event time="x"> converted to timeMs
+    uint64 startTime = 7;          // <event start="x"> converted to timeMs
+    uint64 staleTime = 8;          // <event stale="x"> converted to timeMs
+    string how = 9;                // <event how="x">
+
+    // <point>
+    double lat = 10;               // <point lat="x">
+    double lon = 11;               // <point lon="x">
+    double hae = 12;               // <point hae="x"> use 999999 for unknown
+    double ce = 13;                // <point ce="x"> use 999999 for unknown
+    double le = 14;                // <point ce="x"> use 999999 for unknown
+
+    // comprises children of <detail>
+    // This is optional - if omitted, then the cot message
+    // had no data under <detail>
+    Detail detail = 15;
+}
+

package/assets/detail.proto

@@ -0,0 +1,78 @@
+syntax = "proto3";
+option optimize_for = LITE_RUNTIME;
+
+package atakmap.commoncommo.protobuf.v1;
+
+import "contact.proto";
+import "group.proto";
+import "precisionlocation.proto";
+import "status.proto";
+import "takv.proto";
+import "track.proto";
+
+// CotEvent detail
+// The strong typed message fields are optional. If used, they *MUST* adhere 
+// to the requirements of the message (see their proto file) and
+// their XML source element used to populate the message MUST
+// be omitted from the xmlDetail.
+// WHOLE ELEMENTS MUST BE CONVERTED TO MESSAGES. Do not try to
+// put part of the data from a given element into one of the messages
+// and put other parts of the data in an element of xmlDetail! This applies
+// especially if you add new things to the XML representation which do not
+// have a place in the equivalent protobuf message.  Instead, omit the
+// message and put the entire element in xmlDetail!
+//
+// xmlDetail is optional. If omitted, all Detail data has been
+// converted to the strongly typed message fields.
+// If present, this contains any remaining detail data that has NOT been
+// included in one of the strongly typed message fields.  To process the
+// xmlDetail, the following rules MUST be followed:
+// Senders of this message MUST:
+//     1. Remove child elements used to populate the other message
+//        fields.  If the same child element appears more times than an
+//        associated message field(s) is intended to encompass, or if any
+//        error occurs mapping to the message equivalent, do not remove
+//        the element(s) in question and do not populate the message
+//        equivalent.
+//     2. If no data under <detail> remains, STOP - do not populate
+//        xmlDetail
+//     3. Serialize the remaining XML tree under <detail>....</detail>
+//        as XML in UTF-8 encoding
+//     4. Remove the <detail> and </detail> element tags
+//     5. Remove the XML header
+//     6. Place the result in xmlDetail
+// Receivers of this message MUST do the equivalent of the following:
+//     1. If the field is not present (zero length), stop - do nothing
+//     2. Prepend <detail> and append </detail>
+//     3. Prepend an XML header for UTF-8 encoding, version 1.0 
+//        (<?xml version="1.0" encoding="UTF-8"?> or similar)
+//     4. Read the result, expecting a valid XML document with a document
+//        root of <detail>
+//     5. Merge in XML equivalents of each of the strongly typed
+//        messages present in this Detail message.
+//        In the event that a sending application does not follow 
+//        sending rule #1 above properly and data for the same element
+//        appears in xmlDetail, the data in xmlDetail should be left alone
+//        and the data in the equivalent message should ignored.
+
+message Detail {
+    string xmlDetail = 1;
+
+    // <contact>
+    Contact contact = 2;
+
+    // <__group>
+    Group group = 3;
+
+    // <precisionlocation>
+    PrecisionLocation precisionLocation = 4;
+
+    // <status>
+    Status status = 5;
+
+    // <takv>
+    Takv takv = 6;
+
+    // <track>
+    Track track = 7;
+}

package/assets/group.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+option optimize_for = LITE_RUNTIME;
+
+package atakmap.commoncommo.protobuf.v1;
+
+// All items are required unless otherwise noted!
+// "required" means if they are missing on send, the conversion
+// to the message format will be rejected and fall back to opaque
+// XML representation
+message Group {
+     string name = 1;           // name=
+     string role = 2;           // role=
+}

package/assets/precisionlocation.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+option optimize_for = LITE_RUNTIME;
+
+package atakmap.commoncommo.protobuf.v1;
+
+// All items are required unless otherwise noted!
+// "required" means if they are missing on send, the conversion
+// to the message format will be rejected and fall back to opaque
+// XML representation
+message PrecisionLocation {
+     string geopointsrc = 1;        // geopointsrc=
+     string altsrc = 2;             // altsrc=
+}

package/assets/status.proto

@@ -0,0 +1,12 @@
+syntax = "proto3";
+option optimize_for = LITE_RUNTIME;
+
+package atakmap.commoncommo.protobuf.v1;
+
+// All items are required unless otherwise noted!
+// "required" means if they are missing on send, the conversion
+// to the message format will be rejected and fall back to opaque
+// XML representation
+message Status {
+     uint32 battery = 1;           // battery=
+}

package/assets/takcontrol.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+option optimize_for = LITE_RUNTIME;
+
+package atakmap.commoncommo.protobuf.v1;
+
+// TAK Protocol control message
+// This specifies to a recipient what versions
+// of protocol elements this sender supports during
+// decoding.
+message TakControl {
+    // Lowest TAK protocol version supported
+    // If not filled in (reads as 0), version 1 is assumed
+    uint32 minProtoVersion = 1;
+
+    // Highest TAK protocol version supported
+    // If not filled in (reads as 0), version 1 is assumed
+    uint32 maxProtoVersion = 2;
+
+    // UID of the sending contact. May be omitted if
+    // this message is paired in a TakMessage with a CotEvent
+    // and the CotEvent contains this information
+    string contactUid = 3;
+}
+

package/assets/takmessage.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+option optimize_for = LITE_RUNTIME;
+
+import "cotevent.proto";
+import "takcontrol.proto";
+
+package atakmap.commoncommo.protobuf.v1;
+
+// Top level message sent for TAK Messaging Protocol Version 1.
+message TakMessage {
+    // Optional - if omitted, continue using last reported control
+    // information
+    TakControl takControl = 1;
+
+    // Optional - if omitted, no event data in this message
+    CotEvent cotEvent = 2;
+}
+

package/assets/takv.proto

@@ -0,0 +1,15 @@
+syntax = "proto3";
+option optimize_for = LITE_RUNTIME;
+
+package atakmap.commoncommo.protobuf.v1;
+
+// All items are required unless otherwise noted!
+// "required" means if they are missing on send, the conversion
+// to the message format will be rejected and fall back to opaque
+// XML representation
+message Takv {
+     string device = 1;             // device=
+     string platform = 2;           // platform=
+     string os = 3;                 // os=
+     string version = 4;            // version=
+}

package/assets/track.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+option optimize_for = LITE_RUNTIME;
+
+package atakmap.commoncommo.protobuf.v1;
+
+// All items are required unless otherwise noted!
+// "required" means if they are missing on send, the conversion
+// to the message format will be rejected and fall back to opaque
+// XML representation
+message Track {
+     double speed = 1;           // speed=
+     double course = 2;          // course=
+}

package/index.js

@@ -0,0 +1,7 @@
+import XML from './src/xml.js';
+import Proto from './src/proto.js';
+
+export {
+    XML,
+    Proto
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+    "name": "@tak-ps/node-cot",
+    "type": "module",
+    "version": "1.0.0",
+    "description": "Lightweight JavaScript library for parsing and manipulating TAK messages",
+    "main": "index.js",
+    "scripts": {
+        "test": "tape test/**.test.js",
+        "lint": "eslint *.js src/*.js test/*.js"
+    },
+    "dependencies": {
+        "protobufjs": "^7.1.2",
+        "xml-js": "^1.6.11"
+    },
+    "devDependencies": {
+        "eslint": "^8.28.0",
+        "eslint-plugin-node": "^11.1.0",
+        "tape": "^5.6.1"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/tak-ps/node-cot.git"
+    },
+    "keywords": [
+        "tak",
+        "atak",
+        "wintak",
+        "cot",
+        "cusor",
+        "target",
+        "tactical"
+    ],
+    "author": "Vidterra LLC",
+    "license": "MIT",
+    "bugs": {
+        "url": "https://github.com/tak-ps/node-cot/issues"
+    },
+    "homepage": "https://github.com/tak-ps/node-cot#readme"
+}

package/scripts/convert.js

@@ -0,0 +1,29 @@
+const path = require('path')
+const {cot, proto} = require(path.join(__dirname, '../index.js'))
+
+const run = (message) => {
+    if (!message) {
+        console.error('Enter a TAK message')
+        return
+    }
+
+    const bufferMessage = typeof message !== Buffer ? Buffer.from(message, 'hex') : message
+
+    if (bufferMessage[0] === 191) { // TAK message format 0xbf
+        console.log('TAK message received')
+        const trimmedBuffer = bufferMessage.slice(3, bufferMessage.length) // remove tak message header from content
+        if (bufferMessage[1] === 0) { // is COT XML
+            console.error('Enter a TAK proto message')
+        } else if (bufferMessage[1] === 1) { // is Protobuf
+            console.log('TAK protobuf format')
+            const protoMessage = proto.proto2js(trimmedBuffer)
+            const cotMessage = proto.protojs2cotjs(protoMessage)
+            console.log(cotMessage)
+            console.log(cot.js2xml(cotMessage))
+        }
+    } else { // not TAK message format
+        console.error('Enter a TAK proto message')
+    }
+}
+
+run(process.argv[2])

package/scripts/parse.js

@@ -0,0 +1,34 @@
+const path = require('path')
+const {cot, proto} = require(path.join(__dirname, '../index.js'))
+
+// https://github.com/deptofdefense/AndroidTacticalAssaultKit-CIV/blob/master/commoncommo/core/impl/protobuf/protocol.txt
+
+const run = (message) => {
+    if (!message) {
+        console.error('Enter a TAK message')
+        return
+    }
+
+    const bufferMessage = typeof message !== Buffer ? Buffer.from(message, 'hex') : message
+
+    if (bufferMessage[0] === 191) { // TAK message format 0xbf
+        console.log('TAK message received')
+        const trimmedBuffer = bufferMessage.slice(3, bufferMessage.length) // remove tak message header from content
+        if (bufferMessage[1] === 0) { // is COT XML
+            console.log('COT XML format')
+            console.log(cot.xml2js(trimmedBuffer)) // try parsing raw XML
+        } else if (bufferMessage[1] === 1) { // is Protobuf
+            console.log('TAK protobuf format')
+            console.log(proto.proto2js(trimmedBuffer))
+        }
+    } else { // not TAK message format
+        try {
+            console.log('COT XML received')
+            console.log(cot.xml2js(message)) // try parsing raw XML
+        } catch (e) {
+            console.error('Failed to parse message', e)
+        }
+    }
+}
+
+run(process.argv[2])

package/src/proto.js

@@ -0,0 +1,110 @@
+import path from 'path';
+import protobuf from 'protobufjs';
+import xmljs from 'xml-js';
+
+const root = protobuf.loadSync(path.join(__dirname, '../assets/takmessage.proto'));
+const TakMessage = root.lookupType('atakmap.commoncommo.protobuf.v1.TakMessage');
+
+export default class Proto {
+    static proto2js(message) {
+        if (typeof message === 'undefined' || message === null) {
+            throw new Error('Attempted to parse empty TAK proto message');
+        }
+
+        if (typeof message !== Buffer) {
+            message = Buffer.from(message, 'hex');
+        }
+
+        const result = TakMessage.decode(message);
+        return TakMessage.toObject(result, {
+            longs: String
+        }); // or decode
+    }
+
+    static protojs2cotjs(proto) {
+        if (!proto.cotEvent) return null;
+
+        const cot = {
+            'event': {
+                '_attributes': {
+                    'version': '2.0',
+                    'uid': proto.cotEvent.uid,
+                    'type': proto.cotEvent.type,
+                    'time': new Date(parseInt(proto.cotEvent.sendTime)).toISOString(),
+                    'start': new Date(parseInt(proto.cotEvent.startTime)).toISOString(),
+                    'stale': new Date(parseInt(proto.cotEvent.staleTime)).toISOString(),
+                    'how': proto.cotEvent.how
+                },
+                'point': {
+                    '_attributes': {
+                        'lat': proto.cotEvent.lat,
+                        'lon': proto.cotEvent.lon,
+                        'hae': proto.cotEvent.hae,
+                        'ce': proto.cotEvent.ce,
+                        'le': proto.cotEvent.le
+                    }
+                }
+            }
+        };
+        if (proto.cotEvent.detail) {
+            cot.event.detail = {};
+            if (proto.cotEvent.detail.takv) {
+                cot.event.detail.takv = {
+                    '_attributes': {
+                        'os': proto.cotEvent.detail.takv.os,
+                        'version': proto.cotEvent.detail.takv.version,
+                        'device': proto.cotEvent.detail.takv.device,
+                        'platform': proto.cotEvent.detail.takv.platform
+                    }
+                };
+            }
+            if (proto.cotEvent.detail.contact) {
+                cot.event.detail.contact = {
+                    '_attributes': {
+                        'endpoint': proto.cotEvent.detail.contact.endpoint,
+                        'callsign': proto.cotEvent.detail.contact.callsign
+                    }
+                };
+                // todo add phone
+            }
+            if (proto.cotEvent.detail.xmlDetail) {
+                const result = xmljs.xml2js(proto.cotEvent.detail.xmlDetail, { compact: true });
+                cot.event.detail = {
+                    ...cot.event.detail,
+                    ...result
+                };
+            }
+            if (proto.cotEvent.detail.group) {
+                cot.event.detail.__group = {
+                    '_attributes': {
+                        'role': proto.cotEvent.detail.group.role,
+                        'name': proto.cotEvent.detail.group.name
+                    }
+                };
+            }
+            if (proto.cotEvent.detail.status) {
+                cot.event.detail.status = {
+                    '_attributes': {
+                        'battery': proto.cotEvent.detail.status.battery
+                    }
+                };
+            }
+            /*
+                "precisionlocation": {
+                    "_attributes": {
+                        "altsrc": "GPS",
+                            "geopointsrc": "GPS"
+                    }
+                },
+
+                "track": {
+                    "_attributes": {
+                        "course": "228.71039582198793",
+                            "speed": "0.0"
+                    }
+                }
+            }*/
+        }
+        return cot;
+    }
+}

package/src/xml.js

@@ -0,0 +1,73 @@
+import xmljs from 'xml-js';
+
+export default class XMLCot {
+    static js2xml(js) {
+        if (typeof js === 'undefined' || !js) {
+            throw new Error('Attempted to parse empty Object');
+        }
+
+        return xmljs.js2xml(js, { compact: true });
+    }
+
+    // accepts an Object decoded with xml2js.decodeType(type)
+    static encodeType(type) {
+        let result = type.atom;
+        if (type.descriptor) {
+            result += `-${type.descriptor}`;
+        }
+        if (type.domain) {
+            result += `-${type.domain}`;
+        }
+        if (type.milstd.length > 0) {
+            result += `-${type.milstd.join('-')}`;
+        }
+        return result;
+    }
+
+    static jsDate2cot(unix) {
+        return new Date(unix).toISOString();
+    }
+
+    static xml2js(cot) {
+        if (typeof cot === 'undefined' || cot === null) {
+            throw new Error('Attempted to parse empty COT message');
+        }
+
+        if (typeof cot === 'object') { // accept a data buffer or string for conversion
+            cot = cot.toString();
+        }
+
+        return xmljs.xml2js(cot, { compact: true });
+    }
+
+    // accepts a string formatted like 'a-f-G-U-C-I'
+    static decodeType(type) {
+        const split = type.split('-');
+        const atom = split[0];
+        const descriptor = split[1] || null;
+        const domain = split[2] || null;
+        const milstd = split.slice(3);
+        return {
+            type,
+            atom,
+            descriptor,
+            domain,
+            milstd
+        };
+    }
+
+    static cotDate2js(iso) {
+        return Date.parse(iso);
+    }
+
+    // convert a decoded point from xml2js(cot) from String to Numbers
+    static parsePoint(point) {
+        return {
+            lat: parseFloat(point.lat),
+            lon: parseFloat(point.lon),
+            hae: parseFloat(point.hae),
+            ce: parseFloat(point.ce),
+            le: parseFloat(point.le)
+        };
+    }
+}

package/test/cot.test.js

@@ -0,0 +1,245 @@
+import test from 'tape';
+import XML from '../src/xml.js';
+
+test('Decode COT message', (t) => {
+    const packet = '<event version="2.0" uid="ANDROID-deadbeef" type="a-f-G-U-C" how="m-g" time="2021-02-27T20:32:24.771Z" start="2021-02-27T20:32:24.771Z" stale="2021-02-27T20:38:39.771Z"><point lat="1.234567" lon="-3.141592" hae="-25.7" ce="9.9" le="9999999.0"/><detail><takv os="29" version="4.0.0.0 (deadbeef).1234567890-CIV" device="Some Android Device" platform="ATAK-CIV"/><contact xmppUsername="xmpp@host.com" endpoint="*:-1:stcp" callsign="JENNY"/><uid Droid="JENNY"/><precisionlocation altsrc="GPS" geopointsrc="GPS"/><__group role="Team Member" name="Cyan"/><status battery="78"/><track course="80.24833892285461" speed="0.0"/></detail></event>';
+
+    t.deepEquals(XML.xml2js(packet), {
+        'event': {
+            '_attributes': {
+                'version': '2.0',
+                'uid': 'ANDROID-deadbeef',
+                'type': 'a-f-G-U-C',
+                'how': 'm-g',
+                'time': '2021-02-27T20:32:24.771Z',
+                'start': '2021-02-27T20:32:24.771Z',
+                'stale': '2021-02-27T20:38:39.771Z'
+            },
+            'point': {
+                '_attributes': {
+                    'lat': '1.234567',
+                    'lon': '-3.141592',
+                    'hae': '-25.7',
+                    'ce': '9.9',
+                    'le': '9999999.0'
+                }
+            },
+            'detail': {
+                'takv': {
+                    '_attributes': {
+                        'os': '29',
+                        'version': '4.0.0.0 (deadbeef).1234567890-CIV',
+                        'device': 'Some Android Device',
+                        'platform': 'ATAK-CIV'
+                    }
+                },
+                'contact': {
+                    '_attributes': {
+                        'xmppUsername': 'xmpp@host.com',
+                        'endpoint': '*:-1:stcp',
+                        'callsign': 'JENNY'
+                    }
+                },
+                'uid': { '_attributes': { 'Droid': 'JENNY' } },
+                'precisionlocation': { '_attributes': { 'altsrc': 'GPS', 'geopointsrc': 'GPS' } },
+                '__group': { '_attributes': { 'role': 'Team Member', 'name': 'Cyan' } },
+                'status': { '_attributes': { 'battery': '78' } },
+                'track': { '_attributes': { 'course': '80.24833892285461', 'speed': '0.0' } }
+            }
+        }
+    });
+
+    t.end();
+});
+
+test('Decode COT message', (t) => {
+    const packet = '<event version="2.0" uid="TEST-deadbeef" type="a" how="m-g" time="2021-03-12T15:49:07.138Z" start="2021-03-12T15:49:07.138Z" stale="2021-03-12T15:49:07.138Z"><point lat="0.000000" lon="0.000000" hae="0.0" ce="9999999.0" le="9999999.0"/><detail><takv os="Android" version="10" device="Some Device" platform="python unittest"/><status battery="83"/><uid Droid="JENNY"/><contact callsign="JENNY" endpoint="*:-1:stcp" phone="800-867-5309"/><__group role="Team Member" name="Cyan"/><track course="90.1" speed="10.3"/></detail></event>';
+
+    t.deepEquals(XML.xml2js(packet), {
+        'event': {
+            '_attributes': {
+                'version': '2.0',
+                'uid': 'TEST-deadbeef',
+                'type': 'a',
+                'how': 'm-g',
+                'time': '2021-03-12T15:49:07.138Z',
+                'start': '2021-03-12T15:49:07.138Z',
+                'stale': '2021-03-12T15:49:07.138Z'
+            },
+            'point': {
+                '_attributes': {
+                    'lat': '0.000000',
+                    'lon': '0.000000',
+                    'hae': '0.0',
+                    'ce': '9999999.0',
+                    'le': '9999999.0'
+                }
+            },
+            'detail': {
+                'takv': {
+                    '_attributes': {
+                        'os': 'Android',
+                        'version': '10',
+                        'device': 'Some Device',
+                        'platform': 'python unittest'
+                    }
+                },
+                'status': {
+                    '_attributes': {
+                        'battery': '83'
+                    }
+                },
+                'uid': {
+                    '_attributes': {
+                        'Droid': 'JENNY'
+                    }
+                },
+                'contact': {
+                    '_attributes': {
+                        'callsign': 'JENNY',
+                        'endpoint': '*:-1:stcp',
+                        'phone': '800-867-5309'
+                    }
+                },
+                '__group': {
+                    '_attributes': {
+                        'role': 'Team Member',
+                        'name': 'Cyan'
+                    }
+                },
+                'track': {
+                    '_attributes': {
+                        'course': '90.1',
+                        'speed': '10.3'
+                    }
+                }
+            }
+        }
+    });
+
+    t.end();
+});
+
+test('Encode COT message', (t) => {
+    const packet = {
+        'event': {
+            '_attributes': {
+                'version': '2.0',
+                'uid': 'ANDROID-deadbeef',
+                'type': 'a-f-G-U-C',
+                'how': 'm-g',
+                'time': '2021-02-27T20:32:24.771Z',
+                'start': '2021-02-27T20:32:24.771Z',
+                'stale': '2021-02-27T20:38:39.771Z'
+            },
+            'point': {
+                '_attributes': {
+                    'lat': '1.234567',
+                    'lon': '-3.141592',
+                    'hae': '-25.7',
+                    'ce': '9.9',
+                    'le': '9999999.0'
+                }
+            },
+            'detail': {
+                'takv': {
+                    '_attributes': {
+                        'os': '29',
+                        'version': '4.0.0.0 (deadbeef).1234567890-CIV',
+                        'device': 'Some Android Device',
+                        'platform': 'ATAK-CIV'
+                    }
+                },
+                'contact': {
+                    '_attributes': {
+                        'xmppUsername': 'xmpp@host.com',
+                        'endpoint': '*:-1:stcp',
+                        'callsign': 'JENNY'
+                    }
+                },
+                'uid': { '_attributes': { 'Droid': 'JENNY' } },
+                'precisionlocation': { '_attributes': { 'altsrc': 'GPS', 'geopointsrc': 'GPS' } },
+                '__group': { '_attributes': { 'role': 'Team Member', 'name': 'Cyan' } },
+                'status': { '_attributes': { 'battery': '78' } },
+                'track': { '_attributes': { 'course': '80.24833892285461', 'speed': '0.0' } }
+            }
+        }
+    };
+
+    t.deepEquals(
+        XML.js2xml(packet),
+        '<event version="2.0" uid="ANDROID-deadbeef" type="a-f-G-U-C" how="m-g" time="2021-02-27T20:32:24.771Z" start="2021-02-27T20:32:24.771Z" stale="2021-02-27T20:38:39.771Z"><point lat="1.234567" lon="-3.141592" hae="-25.7" ce="9.9" le="9999999.0"/><detail><takv os="29" version="4.0.0.0 (deadbeef).1234567890-CIV" device="Some Android Device" platform="ATAK-CIV"/><contact xmppUsername="xmpp@host.com" endpoint="*:-1:stcp" callsign="JENNY"/><uid Droid="JENNY"/><precisionlocation altsrc="GPS" geopointsrc="GPS"/><__group role="Team Member" name="Cyan"/><status battery="78"/><track course="80.24833892285461" speed="0.0"/></detail></event>'
+    );
+
+    t.end();
+});
+
+test('Parse GeoChat message', (t) => {
+    const geochat = '<event version="2.0" uid="GeoChat.ANDROID-deadbeef.JOKER MAN.563040b9-2ac9-4af3-9e01-4cb2b05d98ea" type="b-t-f" how="h-g-i-g-o" time="2021-02-23T22:28:22.191Z" start="2021-02-23T22:28:22.191Z" stale="2021-02-24T22:28:22.191Z">\n' +
+        '  <point lat="1.234567" lon="-3.141592" hae="-25.8" ce="9.9" le="9999999.0"/>\n' +
+        '  <detail>\n' +
+        '    <__chat parent="RootContactGroup" groupOwner="false" chatroom="JOKER MAN" id="ANDROID-cafebabe" senderCallsign="JENNY">\n' +
+        '      <chatgrp uid0="ANDROID-deadbeef" uid1="ANDROID-cafebabe" id="ANDROID-cafebabe"/>\n' +
+        '    </__chat>\n' +
+        '    <link uid="ANDROID-deadbeef" type="a-f-G-U-C" relation="p-p"/>\n' +
+        '    <remarks source="BAO.F.ATAK.ANDROID-deadbeef" to="ANDROID-cafebabe" time="2021-02-23T22:28:22.191Z">test</remarks>\n' +
+        '    <__serverdestination destinations="123.45.67.89:4242:tcp:ANDROID-deadbeef"/>\n' +
+        '    <marti>\n' +
+        '      <dest callsign="JOKER MAN"/>\n' +
+        '    </marti>\n' +
+        '  </detail>\n' +
+        '</event>';
+
+    t.deepEquals(XML.xml2js(geochat), {
+        'event': {
+            '_attributes': {
+                'version': '2.0',
+                'uid': 'GeoChat.ANDROID-deadbeef.JOKER MAN.563040b9-2ac9-4af3-9e01-4cb2b05d98ea',
+                'type': 'b-t-f',
+                'how': 'h-g-i-g-o',
+                'time': '2021-02-23T22:28:22.191Z',
+                'start': '2021-02-23T22:28:22.191Z',
+                'stale': '2021-02-24T22:28:22.191Z'
+            },
+            'point': {
+                '_attributes': {
+                    'lat': '1.234567',
+                    'lon': '-3.141592',
+                    'hae': '-25.8',
+                    'ce': '9.9',
+                    'le': '9999999.0'
+                }
+            },
+            'detail': {
+                '__chat': {
+                    '_attributes': {
+                        'parent': 'RootContactGroup',
+                        'groupOwner': 'false',
+                        'chatroom': 'JOKER MAN',
+                        'id': 'ANDROID-cafebabe',
+                        'senderCallsign': 'JENNY'
+                    },
+                    'chatgrp': {
+                        '_attributes': {
+                            'uid0': 'ANDROID-deadbeef',
+                            'uid1': 'ANDROID-cafebabe',
+                            'id': 'ANDROID-cafebabe'
+                        }
+                    }
+                },
+                'link': { '_attributes': { 'uid': 'ANDROID-deadbeef', 'type': 'a-f-G-U-C', 'relation': 'p-p' } },
+                'remarks': {
+                    '_attributes': {
+                        'source': 'BAO.F.ATAK.ANDROID-deadbeef',
+                        'to': 'ANDROID-cafebabe',
+                        'time': '2021-02-23T22:28:22.191Z'
+                    }, '_text': 'test'
+                },
+                '__serverdestination': { '_attributes': { 'destinations': '123.45.67.89:4242:tcp:ANDROID-deadbeef' } },
+                'marti': { 'dest': { '_attributes': { 'callsign': 'JOKER MAN' } } }
+            }
+        }
+    });
+
+    t.end();
+});