@tak-ps/node-cot 3.5.3 → 4.0.0

package/lib/{xml.ts → cot.ts}

@@ -80,14 +80,14 @@ export interface JSONCoT {
  *
  * @prop raw Raw XML-JS representation of CoT
  */
-export default class XMLCot {
+export default class CoT {
     raw: JSONCoT;
 
     constructor(cot: Buffer | JSONCoT | string) {
         if (typeof cot === 'string' || cot instanceof Buffer) {
             if (cot instanceof Buffer) cot = String(cot);
 
-            const raw: any = xmljs.xml2js(cot, { compact: true });
+            const raw = xmljs.xml2js(cot, { compact: true });
             this.raw = raw as JSONCoT;
         } else {
             this.raw = cot;
@@ -100,11 +100,11 @@ export default class XMLCot {
     }
 
     /**
-     * Return an XMLCot Message
+     * Return an CoT Message
      *
      * @param {Object} feature GeoJSON Point Feature
      *
-     * @return {XMLCot}
+     * @return {CoT}
      */
     static from_geojson(feature: Feature) {
         if (feature.type !== 'Feature') throw new Error('Must be GeoJSON Feature');
@@ -199,7 +199,7 @@ export default class XMLCot {
             cot.event.point._attributes.lat = String(centre.geometry.coordinates[1]);
         }
 
-        return new XMLCot(cot);
+        return new CoT(cot);
     }
 
     /**
@@ -226,7 +226,7 @@ export default class XMLCot {
                 type: 'Point',
                 coordinates: [
                     Number(raw.event.point._attributes.lon),
-                    Number(raw.event.point._attributes.lon),
+                    Number(raw.event.point._attributes.lat),
                     Number(raw.event.point._attributes.hae)
                 ]
             }
@@ -235,19 +235,15 @@ export default class XMLCot {
         return geojson;
     }
 
-    to_xml() {
-        return xmljs.js2xml(this.raw, {
-            compact: true
-        });
+    to_xml(): string {
+        return xmljs.js2xml(this.raw, { compact: true });
     }
 
     /**
      * Return a CoT Message
-     *
-     * @returns {XMLCot}
      */
-    static ping() {
-        return new XMLCot({
+    static ping(): CoT {
+        return new CoT({
             event: {
                 _attributes: Util.cot_event_attr('t-x-c-t', 'h-g-i-g-o'),
                 detail: {},
@@ -255,4 +251,166 @@ export default class XMLCot {
             }
         });
     }
+
+    /**
+     * Determines if the CoT message represents a Friendly Element
+     *
+     * @return {boolean}
+     */
+    is_friend(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-f-/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Hostile Element
+     *
+     * @return {boolean}
+     */
+    is_hostile(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-h-/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Unknown Element
+     *
+     * @return {boolean}
+     */
+    is_unknown(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-u-/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Pending Element
+     *
+     * @return {boolean}
+     */
+    is_pending(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-p-/)
+    }
+
+    /**
+     * Determines if the CoT message represents an Assumed Element
+     *
+     * @return {boolean}
+     */
+    is_assumed(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-a-/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Neutral Element
+     *
+     * @return {boolean}
+     */
+    is_neutral(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-n-/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Suspect Element
+     *
+     * @return {boolean}
+     */
+    is_suspect(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-s-/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Joker Element
+     *
+     * @return {boolean}
+     */
+    is_joker(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-j-/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Faker Element
+     *
+     * @return {boolean}
+     */
+    is_faker(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-k-/)
+    }
+
+    /**
+     * Determines if the CoT message represents an Element
+     *
+     * @return {boolean}
+     */
+    is_atom(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-/)
+    }
+
+    /**
+     * Determines if the CoT message represents an Airborne Element
+     *
+     * @return {boolean}
+     */
+    is_airborne(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-.-A/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Ground Element
+     *
+     * @return {boolean}
+     */
+    is_ground(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-.-G/)
+    }
+
+    /**
+     * Determines if the CoT message represents an Installation
+     *
+     * @return {boolean}
+     */
+    is_installation(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-.-G-I/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Vehicle
+     *
+     * @return {boolean}
+     */
+    is_vehicle(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-.-G-E-V/)
+    }
+
+    /**
+     * Determines if the CoT message represents Equipment
+     *
+     * @return {boolean}
+     */
+    is_equipment(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-.-G-E/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Surface Element
+     *
+     * @return {boolean}
+     */
+    is_surface(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-.-S/)
+    }
+
+    /**
+     * Determines if the CoT message represents a Subsurface Element
+     *
+     * @return {boolean}
+     */
+    is_subsurface(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-.-U/)
+    }
+
+    /**
+     * Determines if the CoT message represents a UAV Element
+     *
+     * @return {boolean}
+     */
+    is_uav(): boolean {
+        return !!this.raw.event._attributes.type.match(/^a-f-A-M-F-Q-r/)
+    }
 }

package/lib/util.ts

@@ -4,7 +4,7 @@ import type {
     TrackAttributes,
     Detail,
     Point
-} from './xml.js';
+} from './cot.js';
 
 /**
  * Helper functions for generating CoT data

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@tak-ps/node-cot",
     "type": "module",
-    "version": "3.5.3",
+    "version": "4.0.0",
     "description": "Lightweight JavaScript library for parsing and manipulating TAK messages",
     "author": "Nick Ingalls <nick@ingalls.ca>",
     "main": "dist/index.js",
@@ -26,8 +26,8 @@
     "devDependencies": {
         "@types/node": "^20.0.0",
         "@types/tape": "^5.6.0",
-        "@typescript-eslint/eslint-plugin": "^5.54.0",
-        "@typescript-eslint/parser": "^5.54.0",
+        "@typescript-eslint/eslint-plugin": "^6.0.0",
+        "@typescript-eslint/parser": "^6.0.0",
         "eslint": "^8.35.0",
         "eslint-plugin-node": "^11.1.0",
         "tape": "^5.6.1",

package/test/cot.test.ts

@@ -1,10 +1,10 @@
 import test from 'tape';
-import { XML } from '../index.js';
+import CoT from '../index.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((new XML(packet)).raw, {
+    t.deepEquals((new CoT(packet)).raw, {
         'event': {
             '_attributes': {
                 'version': '2.0',
@@ -55,7 +55,7 @@ test('Decode COT message', (t) => {
 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((new XML(packet)).raw, {
+    t.deepEquals((new CoT(packet)).raw, {
         'event': {
             '_attributes': {
                 'version': '2.0',
@@ -167,7 +167,7 @@ test('Encode COT message', (t) => {
     };
 
     t.deepEquals(
-        (new XML(packet)).to_xml(),
+        (new CoT(packet)).to_xml(),
         '<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"/><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>'
     );
 
@@ -190,7 +190,7 @@ test('Parse GeoChat message', (t) => {
         '  </detail>\n' +
         '</event>';
 
-    t.deepEquals((new XML(geochat)).raw, {
+    t.deepEquals((new CoT(geochat)).raw, {
         'event': {
             '_attributes': {
                 'version': '2.0',