@squawk/mode-s 0.3.0 → 0.3.1

package/dist/acas.d.ts

@@ -7,6 +7,15 @@ import type { AcasResolutionAdvisoryReport } from './types/index.js';
  * TC28/ST2's ME uses that same first byte for its type-code-and-subtype
  * header instead - either way, content starts at bit 8).
  *
+ * This function assumes `payload` is already known to carry a genuine BDS
+ * 3,0 report - it does not itself check DF16's register-identifier byte,
+ * since a TC28/ST2 caller's first byte is never that identifier by
+ * construction. A DF16 caller must check that byte itself before calling
+ * this (see `decodeModeSMessage`'s DF16 branch) - DF16's MV is a
+ * general-purpose Comm-B register slot that can legitimately carry a
+ * different register, unlike TC28/ST2 which is gated by its own type-code
+ * and subtype instead.
+ *
  * @param payload - The 7-byte field: DF16's MV, or a type-code-28 subtype-2 ME.
  * @returns The decoded report, or undefined if the Threat Type Indicator is the reserved value (not a legitimate report).
  */

package/dist/acas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"acas.d.ts","sourceRoot":"","sources":["../src/acas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,4BAA4B,EAG7B,MAAM,kBAAkB,CAAC;AA4D1B;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,UAAU,GAClB,4BAA4B,GAAG,SAAS,CAuC1C"}
+{"version":3,"file":"acas.d.ts","sourceRoot":"","sources":["../src/acas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,4BAA4B,EAG7B,MAAM,kBAAkB,CAAC;AA4D1B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,UAAU,GAClB,4BAA4B,GAAG,SAAS,CAuC1C"}

package/dist/acas.js

@@ -55,6 +55,15 @@ function decodeAdvisoryType(active, corrective, downwardSense, increasedRate, se
  * TC28/ST2's ME uses that same first byte for its type-code-and-subtype
  * header instead - either way, content starts at bit 8).
  *
+ * This function assumes `payload` is already known to carry a genuine BDS
+ * 3,0 report - it does not itself check DF16's register-identifier byte,
+ * since a TC28/ST2 caller's first byte is never that identifier by
+ * construction. A DF16 caller must check that byte itself before calling
+ * this (see `decodeModeSMessage`'s DF16 branch) - DF16's MV is a
+ * general-purpose Comm-B register slot that can legitimately carry a
+ * different register, unlike TC28/ST2 which is gated by its own type-code
+ * and subtype instead.
+ *
  * @param payload - The 7-byte field: DF16's MV, or a type-code-28 subtype-2 ME.
  * @returns The decoded report, or undefined if the Threat Type Indicator is the reserved value (not a legitimate report).
  */

package/dist/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,kBAAkB,CAAC;AAuN1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,GAAG,SAAS,CAiGrF"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,kBAAkB,CAAC;AA0N1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,GAAG,SAAS,CA2GrF"}

package/dist/message.js

@@ -20,6 +20,8 @@ import { decodeAirborneVelocity } from './velocity.js';
  * rather than a legitimate code.
  */
 const MAX_PLAUSIBLE_INTERROGATOR_CODE = 127;
+/** BDS 3,0 (ACAS Active Resolution Advisory) register identifier, per ICAO Annex 10 Vol IV - the value a DF16 reply's MV field starts with when (and only when) it actually carries an RA report. */
+const BDS_3_0_IDENTIFIER = 0x30;
 const TYPE_CODE_CATEGORIES = [
     { min: 0, max: 0, category: 'airborneBaroPosition' },
     { min: 1, max: 4, category: 'identification' },
@@ -254,10 +256,20 @@ export function decodeModeSMessage(bytes) {
         };
     }
     if (envelope.downlinkFormat === 16) {
+        const mv = bytes.slice(4, 11);
+        // Unlike TC28/ST2 (gated by its own type-code+subtype, checked before
+        // decodeAcasResolutionAdvisory is ever called), DF16's MV field is a
+        // general-purpose Comm-B register slot - it only carries a BDS 3,0
+        // report when its own register-identifier byte says so. A transponder
+        // can legitimately reply to a UF16 interrogation with a different
+        // register loaded into MV, so decoding it unconditionally would
+        // misinterpret unrelated register content as a phantom Resolution
+        // Advisory.
+        const isBds30 = extractBits(mv, 0, 8) === BDS_3_0_IDENTIFIER;
         return {
             kind: 'longAirAirSurveillanceReply',
             ...decodeAirAirSurveillanceCore(bytes, envelope.crcRemainder),
-            resolutionAdvisory: decodeAcasResolutionAdvisory(bytes.slice(4, 11)),
+            resolutionAdvisory: isBds30 ? decodeAcasResolutionAdvisory(mv) : undefined,
         };
     }
     if (envelope.downlinkFormat === 4) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squawk/mode-s",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "Decode raw Mode-S/ADS-B messages: DF/CRC parsing, CPR position, velocity, identification, and altitude",
   "author": "Neil Cochran",