@aeroswarm/codec 0.1.8 → 0.1.9

package/README.md

@@ -52,11 +52,35 @@ In the services this is wired to the `ASTERIX_EDITIONS` env var (format `"21:0.2
 | CAT023 | CNS/ATM ground station & service status | 1.2 |
 | CAT034 | Radar service messages (north marker, sector crossing) — sensor id only | 1.27, 1.26 |
 | CAT048 | Monoradar (PSR/SSR) target reports | 1.21, 1.14 |
-| CAT062 | System/fused tracks from ATC (keyed by system track number; identity item 380 is compound and not yet unpacked) | 1.18, 1.16, 1.9, 1.7, 0.17 |
+| CAT062 | System/fused tracks from ATC (keyed by system track number; item 380 is compound — only the target address `ADR` is unpacked into `icao24`) | 1.18, 1.16, 1.9, 1.7, 0.17 |
 | CAT063 | Sensor status — sensor id only | 1.3 |
 
+CAT021 (edition 1.4+) and CAT048 also expose `trackNumber` (I021/161, I048/161), so reports without a Mode-S address can still be tracked per sensor.
+
 Definitions are standard `asterix` XML files in [`src/config/`](src/config/). More category XMLs are already present there (CAT001, 002, 004, …) but not yet registered — see "Adding a category" below.
 
+## AFTN / ATS messages
+
+Flight-plan data, not positions: `parseAftn` turns one raw AFTN message (FPL, CHG, DLA, DEP, ARR, CNL) into plain JSON.
+
+```ts
+import { parseAftn, splitAftnStream } from "@aeroswarm/codec";
+
+// UDP: one message per datagram
+const msg = parseAftn(datagram);            // AftnMessage | null
+// msg.callsign "BTK7630" · msg.adep "WARR" · msg.ades "WIII" · msg.aircraftType "A320"
+// msg.cruiseSpeed "N0450" · msg.cruiseLevel "F350" · msg.route "DCT ABMAL L897 BIKMA DCT"
+// msg.icao24 "8a0123" (item 18 CODE/) · msg.eobtAt / atdAt / ataAt (epoch ms, UTC)
+
+// TCP: a message ends at NNNN or ETX
+const { messages, rest } = splitAftnStream(buffered + chunk);
+```
+
+- Tolerates gateway framing: SOH/STX/ETX, a `ZCZC` start line, `NNNN`, unknown header lines. Returns `null` when no `( … )` body is present — never throws.
+- Month and year are resolved from `DOF/` or, failing that, the origin `DDHHMM` group nearest to `options.now`.
+- `icao24` comes from `CODE/` and is the precise key for correlating a plan with a surveillance track; callsign is the fallback.
+- Route stays a string (airways, fixes, `DCT`, coordinates) — turning fixes into coordinates needs an AIRAC database this package does not carry.
+
 ## Exposed API
 
 ### `parseAsterix(buf, defaultEdition?)`
@@ -90,6 +114,7 @@ interface AsterixFields {
   lat?: number; lon?: number; // WGS-84 degrees
   altitudeFt?: number;
   timeOfDay?: number;         // seconds since UTC midnight
+  trackNumber?: number;       // per-sensor track number (CAT010/011/020/021/048/062)
   velocity?: { groundSpeedKt?: number; headingDeg?: number };
   positionCartesian?: { xNm?: number; yNm?: number };
   measuredPosition?: { rangeNm?: number; azimuthDeg?: number };

package/dist/index.js

@@ -268,6 +268,11 @@ function str(raw, ...names) {
 function validLatLon(lat, lon) {
   return lat >= -90 && lat <= 90 && lon >= -180 && lon <= 180;
 }
+function trdFlags(raw, out) {
+  if (num(raw, "TST") === 1) out.testTarget = true;
+  if (num(raw, "RAB") === 1) out.fixedTransponder = true;
+  if (num(raw, "SIM") === 1) out.simulated = true;
+}
 function decodeKnownField(cat, id, data, out, raw = {}) {
   try {
     if (cat === 21) cat021(id, data, out, raw);
@@ -299,6 +304,10 @@ function catSystemStatus(id, d, out, raw) {
 }
 function cat021(id, d, out, raw) {
   switch (id) {
+    case "040":
+      trdFlags(raw, out);
+      break;
+    // I021/040 TRD
     case "010": {
       const sac = num(raw, "SAC"), sic = num(raw, "SIC");
       if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
@@ -387,6 +396,12 @@ function cat021(id, d, out, raw) {
       else if (d.length >= 2) out.squawk = (d.readUIntBE(0, 2) & 4095).toString(8).padStart(4, "0");
       break;
     }
+    case "161": {
+      const tn = num(raw, "TrackN", "Tn");
+      if (tn !== void 0) out.trackNumber = tn;
+      else if (d.length >= 2) out.trackNumber = d.readUIntBE(0, 2) & 4095;
+      break;
+    }
     case "030": {
       const t = num(raw, "ToD");
       if (t !== void 0) out.timeOfDay = t;
@@ -397,6 +412,10 @@ function cat021(id, d, out, raw) {
 }
 function cat048(id, d, out, raw) {
   switch (id) {
+    case "020":
+      trdFlags(raw, out);
+      break;
+    // I048/020 TRD
     case "010": {
       const sac = num(raw, "SAC"), sic = num(raw, "SIC");
       if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
@@ -416,6 +435,12 @@ function cat048(id, d, out, raw) {
       } else if (d.length >= 6) out.callsign = readCallsign(d);
       break;
     }
+    case "161": {
+      const tn = num(raw, "Tn");
+      if (tn !== void 0) out.trackNumber = tn;
+      else if (d.length >= 2) out.trackNumber = d.readUIntBE(0, 2) & 4095;
+      break;
+    }
     case "042": {
       const x = num(raw, "X"), y = num(raw, "Y");
       if (x !== void 0 && y !== void 0) out.positionCartesian = { xNm: x, yNm: y };
@@ -520,6 +545,10 @@ function cat023(id, d, out, raw) {
 }
 function cat010(id, d, out, raw) {
   switch (id) {
+    case "020":
+      trdFlags(raw, out);
+      break;
+    // I010/020 TRD
     case "010": {
       const sac = num(raw, "SAC"), sic = num(raw, "SIC");
       if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
@@ -589,6 +618,10 @@ function cat010(id, d, out, raw) {
 var MS_TO_KT = 1 / 0.514444;
 function cat062(id, d, out, raw) {
   switch (id) {
+    case "080":
+      trdFlags(raw, out);
+      break;
+    // I062/080 TRD
     case "010": {
       const sac = num(raw, "SAC"), sic = num(raw, "SIC");
       if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
@@ -628,6 +661,17 @@ function cat062(id, d, out, raw) {
       else if (d.length >= 2) out.trackNumber = d.readUIntBE(0, 2);
       break;
     }
+    case "380": {
+      let fsLen = 0;
+      while (fsLen < d.length) {
+        fsLen++;
+        if ((d[fsLen - 1] & 1) === 0) break;
+      }
+      if (fsLen < d.length && (d[0] & 128) !== 0 && d.length >= fsLen + 3) {
+        out.icao24 = d.readUIntBE(fsLen, 3).toString(16).padStart(6, "0");
+      }
+      break;
+    }
     case "070": {
       const t = num(raw, "ToD", "TOTI");
       if (t !== void 0) out.timeOfDay = t;
@@ -647,6 +691,10 @@ function catServiceMsg(id, d, out, raw) {
 }
 function cat020(id, d, out, raw) {
   switch (id) {
+    case "020":
+      trdFlags(raw, out);
+      break;
+    // I020/020 TRD
     case "010": {
       const sac = num(raw, "SAC"), sic = num(raw, "SIC");
       if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
@@ -913,12 +961,289 @@ function decodeMlatFrame(_frame) {
 function decodeAsmgcsFrame(_frame) {
   return null;
 }
+
+// src/surveillance/aftn/parser.ts
+var PRIORITY_LINE = /^(SS|DD|FF|GG|KK)\s+(.+)$/;
+var ORIGIN_LINE = /^(\d{6})\s+([A-Z]{8})\b/;
+var ADDRESSEES_ONLY = /^(?:[A-Z]{8}\s*)+$/;
+var AERODROME_TIME = /^([A-Z]{4})(\d{4})?/;
+var ITEM18_ENTRY = /([A-Z]{2,5})\/(.*?)(?=\s+[A-Z]{2,5}\/|\s*$)/gs;
+function normalise(input) {
+  const text = typeof input === "string" ? input : input.toString("latin1");
+  return text.replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, "").replace(/\r\n?/g, "\n").replace(/^\s*ZCZC[^\n]*\n/m, "").replace(/\s*NNNN\s*$/, "");
+}
+function parseHeader(headerText) {
+  const header = { addressees: [] };
+  const lines = headerText.split("\n").map((l) => l.trim()).filter(Boolean);
+  let inAddressees = false;
+  for (const line of lines) {
+    const origin = ORIGIN_LINE.exec(line);
+    if (origin) {
+      header.originTime = origin[1];
+      header.originator = origin[2];
+      inAddressees = false;
+      continue;
+    }
+    const prio = PRIORITY_LINE.exec(line);
+    if (prio && !header.priority) {
+      header.priority = prio[1];
+      header.addressees.push(...prio[2].match(/[A-Z]{8}/g) ?? []);
+      inAddressees = true;
+      continue;
+    }
+    if (inAddressees && ADDRESSEES_ONLY.test(line)) {
+      header.addressees.push(...line.match(/[A-Z]{8}/g) ?? []);
+    }
+  }
+  return header;
+}
+function parseItem18(raw) {
+  const out = {};
+  const text = raw.trim();
+  if (!text || text === "0") return out;
+  for (const m of text.matchAll(ITEM18_ENTRY)) {
+    const key = m[1];
+    const value = m[2].trim();
+    if (value && out[key] === void 0) out[key] = value;
+  }
+  return out;
+}
+function splitCallsign(token) {
+  const cs = token?.split("/")[0]?.trim().toUpperCase();
+  return cs || void 0;
+}
+function applyAerodromeTime(token, onAerodrome, onTime) {
+  const m = token ? AERODROME_TIME.exec(token.trim().toUpperCase()) : null;
+  if (!m) return;
+  onAerodrome(m[1]);
+  if (m[2] && onTime) onTime(m[2]);
+}
+function applyItem18(msg, entries) {
+  Object.assign(msg.other, entries);
+  if (entries["REG"]) msg.registration = entries["REG"].replace(/[^A-Z0-9-]/gi, "").toUpperCase() || void 0;
+  if (entries["DOF"] && /^\d{6}$/.test(entries["DOF"])) msg.dof = entries["DOF"];
+  const code = entries["CODE"]?.trim();
+  if (code && /^[0-9A-Fa-f]{6}$/.test(code)) msg.icao24 = code.toLowerCase();
+}
+var SPEED_LEVEL_ROUTE = /^([NMK]\d{3,4})(F\d{3}|A\d{3}|S\d{4}|M\d{4}|VFR)?\s*(.*)$/;
+var TYPE_WAKE = /^\d{0,2}([A-Z0-9]{2,4})\/([LMHJ])$/;
+function applyRoute(msg, text) {
+  const route = text?.trim().toUpperCase();
+  if (!route) return;
+  const m = SPEED_LEVEL_ROUTE.exec(route);
+  if (!m) {
+    msg.route = route;
+    return;
+  }
+  msg.cruiseSpeed = m[1];
+  if (m[2]) msg.cruiseLevel = m[2];
+  if (m[3]) msg.route = m[3].trim();
+}
+function applyAircraft(msg, text) {
+  const aircraft = text?.trim().toUpperCase();
+  if (!aircraft) return;
+  const m = TYPE_WAKE.exec(aircraft);
+  if (m) {
+    msg.aircraftType = m[1];
+    msg.wake = m[2];
+  } else msg.aircraftType = aircraft;
+}
+function parseFpl(parts, msg) {
+  msg.callsign = splitCallsign(parts[1]);
+  const rulesType = parts[2]?.trim().toUpperCase();
+  if (rulesType) {
+    msg.flightRules = rulesType[0];
+    if (rulesType[1]) msg.flightType = rulesType[1];
+  }
+  applyAircraft(msg, parts[3]);
+  if (parts[4]) msg.equipment = parts[4].trim();
+  applyAerodromeTime(parts[5], (a) => {
+    msg.adep = a;
+  }, (t) => {
+    msg.eobt = t;
+  });
+  applyRoute(msg, parts[6]);
+  const dest = parts[7]?.trim().toUpperCase();
+  if (dest) {
+    const m = /^([A-Z]{4})(\d{4})?(?:\s+([A-Z]{4}))?(?:\s+([A-Z]{4}))?/.exec(dest);
+    if (m) {
+      msg.ades = m[1];
+      if (m[2]) msg.eet = m[2];
+      const alts = [m[3], m[4]].filter((x) => !!x);
+      if (alts.length) msg.alternates = alts;
+    }
+  }
+  applyItem18(msg, parseItem18(parts.slice(8).join("-")));
+}
+function parseChg(parts, msg) {
+  msg.callsign = splitCallsign(parts[1]);
+  applyAerodromeTime(parts[2], (a) => {
+    msg.adep = a;
+  }, (t) => {
+    msg.eobt = t;
+  });
+  applyAerodromeTime(parts[3], (a) => {
+    msg.ades = a;
+  });
+  const changes = {};
+  const item18Chunks = [];
+  for (const part of parts.slice(4)) {
+    const numbered = /^(\d{1,2})\/(.*)$/.exec(part.trim());
+    if (numbered) changes[numbered[1]] = numbered[2].trim();
+    else item18Chunks.push(part);
+  }
+  if (Object.keys(changes).length) {
+    msg.changes = changes;
+    const f13 = changes["13"];
+    if (f13) applyAerodromeTime(f13, (a) => {
+      msg.adep = a;
+    }, (t) => {
+      msg.eobt = t;
+    });
+    applyRoute(msg, changes["15"]);
+    const f16 = changes["16"]?.toUpperCase();
+    if (f16) applyAerodromeTime(f16, (a) => {
+      msg.ades = a;
+    }, (t) => {
+      msg.eet = t;
+    });
+    applyAircraft(msg, changes["9"]);
+    const f18 = changes["18"];
+    if (f18) applyItem18(msg, parseItem18(f18));
+  }
+  if (item18Chunks.length) applyItem18(msg, parseItem18(item18Chunks.join(" ")));
+}
+function parseMovement(parts, msg) {
+  msg.callsign = splitCallsign(parts[1]);
+  const type = msg.type;
+  if (type === "DEP") {
+    applyAerodromeTime(parts[2], (a) => {
+      msg.adep = a;
+    }, (t) => {
+      msg.atd = t;
+    });
+    applyAerodromeTime(parts[3], (a) => {
+      msg.ades = a;
+    });
+  } else if (type === "ARR") {
+    applyAerodromeTime(parts[2], (a) => {
+      msg.adep = a;
+    });
+    applyAerodromeTime(parts[3], (a) => {
+      msg.ades = a;
+    }, (t) => {
+      msg.ata = t;
+    });
+  } else if (type === "DLA") {
+    applyAerodromeTime(parts[2], (a) => {
+      msg.adep = a;
+    }, (t) => {
+      msg.eobt = t;
+    });
+    applyAerodromeTime(parts[3], (a) => {
+      msg.ades = a;
+    });
+  } else {
+    applyAerodromeTime(parts[2], (a) => {
+      msg.adep = a;
+    });
+    applyAerodromeTime(parts[3], (a) => {
+      msg.ades = a;
+    });
+  }
+  applyItem18(msg, parseItem18(parts.slice(4).join(" ")));
+}
+function resolveBaseDay(msg, now) {
+  if (msg.dof) {
+    const yy = Number(msg.dof.slice(0, 2));
+    return { y: 2e3 + yy, m: Number(msg.dof.slice(2, 4)) - 1, d: Number(msg.dof.slice(4, 6)) };
+  }
+  const origin = msg.header.originTime;
+  if (!origin) return null;
+  const day = Number(origin.slice(0, 2));
+  const ref = new Date(now);
+  let best = null;
+  let bestDiff = Infinity;
+  for (const offset of [-1, 0, 1]) {
+    const probe = new Date(Date.UTC(ref.getUTCFullYear(), ref.getUTCMonth() + offset, day));
+    if (probe.getUTCDate() !== day) continue;
+    const diff = Math.abs(probe.getTime() - now);
+    if (diff < bestDiff) {
+      bestDiff = diff;
+      best = { y: probe.getUTCFullYear(), m: probe.getUTCMonth(), d: day };
+    }
+  }
+  return best;
+}
+function toEpoch(base, hhmm) {
+  if (!hhmm || !/^\d{4}$/.test(hhmm)) return void 0;
+  const hh = Number(hhmm.slice(0, 2));
+  const mm = Number(hhmm.slice(2, 4));
+  if (hh > 23 || mm > 59) return void 0;
+  return Date.UTC(base.y, base.m, base.d, hh, mm);
+}
+function parseAftn(input, options = {}) {
+  const s = normalise(input);
+  const open = s.indexOf("(");
+  const close = s.lastIndexOf(")");
+  if (open < 0 || close <= open) return null;
+  const text = s.slice(open, close + 1).replace(/\s*\n\s*/g, " ").trim();
+  const inner = text.slice(1, -1);
+  const parts = inner.split("-").map((p) => p.trim());
+  const type = parts[0];
+  if (!type || !/^[A-Z]{3}$/.test(type)) return null;
+  const msg = {
+    type,
+    header: parseHeader(s.slice(0, open)),
+    text,
+    other: {}
+  };
+  switch (type) {
+    case "FPL":
+      parseFpl(parts, msg);
+      break;
+    case "CHG":
+      parseChg(parts, msg);
+      break;
+    case "DEP":
+    case "ARR":
+    case "DLA":
+    case "CNL":
+      parseMovement(parts, msg);
+      break;
+    default:
+      msg.callsign = splitCallsign(parts[1]);
+  }
+  const base = resolveBaseDay(msg, options.now ?? Date.now());
+  if (base) {
+    msg.eobtAt = toEpoch(base, msg.eobt);
+    msg.atdAt = toEpoch(base, msg.atd);
+    msg.ataAt = toEpoch(base, msg.ata);
+  }
+  return msg;
+}
+function splitAftnStream(buffer) {
+  const messages = [];
+  let rest = buffer;
+  const terminator = /NNNN|\x03/;
+  for (; ; ) {
+    const m = terminator.exec(rest);
+    if (!m) break;
+    const end = m.index + m[0].length;
+    const chunk = rest.slice(0, end);
+    if (chunk.includes("(")) messages.push(chunk);
+    rest = rest.slice(end);
+  }
+  return { messages, rest };
+}
 export {
   decodeAdsbFrame,
   decodeAis,
   decodeAsmgcsFrame,
   decodeMlatFrame,
+  parseAftn,
   parseAsterix,
   resolveAsterixAltitudeFt,
-  resolveAsterixPosition
+  resolveAsterixPosition,
+  splitAftnStream
 };

package/dist/surveillance/aftn/index.d.ts

@@ -0,0 +1,3 @@
+export { parseAftn, splitAftnStream } from "./parser.js";
+export type { AftnMessage, AftnHeader, ParseAftnOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/surveillance/aftn/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/surveillance/aftn/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/surveillance/aftn/parser.d.ts

@@ -0,0 +1,16 @@
+import type { AftnMessage, ParseAftnOptions } from "./types.js";
+/**
+ * Parse one AFTN message (raw datagram / TCP-delimited text).
+ *
+ * Tolerant of gateway framing: control characters (SOH/STX/ETX), a
+ * classic `ZCZC` start line, `NNNN` terminator and unknown header lines are
+ * ignored. Returns `null` when no `( … )` ATS message body is present.
+ */
+export declare function parseAftn(input: string | Buffer, options?: ParseAftnOptions): AftnMessage | null;
+/** Split a TCP byte stream into complete messages: a message ends at `NNNN`
+ *  or ETX (0x03). Returns the complete messages and the unconsumed tail. */
+export declare function splitAftnStream(buffer: string): {
+    messages: string[];
+    rest: string;
+};
+//# sourceMappingURL=parser.d.ts.map

package/dist/surveillance/aftn/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/surveillance/aftn/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAsN5E;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,GAAG,IAAI,CAsCpG;AAED;4EAC4E;AAC5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAapF"}

package/dist/surveillance/aftn/parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parser.test.d.ts.map

package/dist/surveillance/aftn/parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.d.ts","sourceRoot":"","sources":["../../../src/surveillance/aftn/parser.test.ts"],"names":[],"mappings":""}

package/dist/surveillance/aftn/types.d.ts

@@ -0,0 +1,75 @@
+/** Parsed AFTN message header (priority / addressees / origin group). */
+export interface AftnHeader {
+    /** Priority indicator: SS, DD, FF, GG or KK */
+    priority?: string;
+    /** 8-letter addressee indicators */
+    addressees: string[];
+    /** Origin time group, DDHHMM (UTC) */
+    originTime?: string;
+    /** 8-letter originator indicator */
+    originator?: string;
+}
+/**
+ * One parsed ATS message (ICAO Doc 4444 App. 3 formats: FPL, CHG, DLA, DEP,
+ * ARR, CNL; any other 3-letter type is returned with identity fields only).
+ *
+ * Plain JSON — safe to publish on Kafka as-is.
+ */
+export interface AftnMessage {
+    /** FPL | CHG | DLA | DEP | ARR | CNL | … */
+    type: string;
+    header: AftnHeader;
+    /** Message text from "(" to ")" with line breaks normalised to spaces */
+    text: string;
+    /** Aircraft identification (item 7), upper-case */
+    callsign?: string;
+    /** I (IFR) · V (VFR) · Y (IFR→VFR) · Z (VFR→IFR) */
+    flightRules?: string;
+    /** S scheduled · N non-scheduled · G general · M military · X other */
+    flightType?: string;
+    /** ICAO aircraft type designator, e.g. A320 */
+    aircraftType?: string;
+    /** L / M / H / J */
+    wake?: string;
+    /** Item 10 as sent (communication/navigation/surveillance equipment) */
+    equipment?: string;
+    /** Departure aerodrome (ICAO) */
+    adep?: string;
+    /** Destination aerodrome (ICAO) */
+    ades?: string;
+    /** Estimated off-block time HHMM (FPL), or the new EOBT (DLA) */
+    eobt?: string;
+    /** Actual time of departure HHMM (DEP) */
+    atd?: string;
+    /** Actual time of arrival HHMM (ARR) */
+    ata?: string;
+    /** Estimated elapsed time HHMM (FPL item 16) */
+    eet?: string;
+    /** Cruising speed group, e.g. N0450 / M078 / K0830 */
+    cruiseSpeed?: string;
+    /** Cruising level group, e.g. F350 / A045 / S1010 / VFR */
+    cruiseLevel?: string;
+    /** Route string (airways, fixes, DCT, coordinates) after speed/level */
+    route?: string;
+    /** Alternate aerodromes */
+    alternates?: string[];
+    /** Item 18 keyed entries: REG, DOF, EET, CODE, PBN, NAV, OPR, RMK, … */
+    other: Record<string, string>;
+    /** Aircraft registration (REG/) */
+    registration?: string;
+    /** 24-bit Mode-S address, lower-case hex (CODE/) — correlates with a track's icao24 */
+    icao24?: string;
+    /** Date of flight YYMMDD (DOF/) */
+    dof?: string;
+    /** CHG only: ICAO item number → new data */
+    changes?: Record<string, string>;
+    /** Epoch ms (UTC) resolved from DOF/origin day + the HHMM groups above */
+    eobtAt?: number;
+    atdAt?: number;
+    ataAt?: number;
+}
+export interface ParseAftnOptions {
+    /** Reference time used to resolve month/year when DOF/ is absent. Default: now. */
+    now?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/surveillance/aftn/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/surveillance/aftn/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/surveillance/asterix/fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA0D7C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,GAAE,SAAc,GAAG,IAAI,CAWrH"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoE7C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,GAAE,SAAc,GAAG,IAAI,CAWrH"}

package/dist/surveillance/asterix/types.d.ts

@@ -41,6 +41,12 @@ export interface AsterixFields {
     vehicleFleet?: number;
     /** Sensor-assigned local track number */
     trackNumber?: number;
+    /** TST bit — test target */
+    testTarget?: boolean;
+    /** RAB bit — report from a fixed field-monitor transponder (MLAT RPU etc.) */
+    fixedTransponder?: boolean;
+    /** SIM bit — simulated target */
+    simulated?: boolean;
 }
 export interface AsterixRecord {
     category: number;

package/dist/surveillance/asterix/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,iBAAiB,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1C,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IACnG,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,iBAAiB,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1C,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IACnG,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;CACvB"}

package/dist/surveillance/index.d.ts

@@ -3,4 +3,5 @@ export * from "./adsb/index.js";
 export * from "./ais/index.js";
 export * from "./mlat/index.js";
 export * from "./asmgcs/index.js";
+export * from "./aftn/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/surveillance/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/surveillance/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/surveillance/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/package.json

@@ -1,40 +1,40 @@
-{
-  "name": "@aeroswarm/codec",
-  "version": "0.1.8",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts",
-      "main": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "src/config"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --clean && tsc --emitDeclarationOnly",
-    "dev": "tsup src/index.ts --format esm --dts --watch",
-    "test": "vitest run --passWithNoTests",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "pnpm run typecheck && pnpm run test && pnpm run build",
-    "release": "release-it",
-    "release:dry": "release-it --dry-run",
-    "release:patch": "release-it patch --no-git.requireCleanWorkingDir",
-    "release:minor": "release-it minor --no-git.requireCleanWorkingDir",
-    "release:major": "release-it major --no-git.requireCleanWorkingDir"
-  },
-  "devDependencies": {
-    "release-it": "^18.1.2",
-    "tsup": "^8.5.1",
-    "vitest": "^4.1.6"
-  }
-}
+{
+  "name": "@aeroswarm/codec",
+  "version": "0.1.9",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "main": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/config"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean && tsc --emitDeclarationOnly",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run typecheck && pnpm run test && pnpm run build",
+    "release": "release-it",
+    "release:dry": "release-it --dry-run",
+    "release:patch": "release-it patch --no-git.requireCleanWorkingDir",
+    "release:minor": "release-it minor --no-git.requireCleanWorkingDir",
+    "release:major": "release-it major --no-git.requireCleanWorkingDir"
+  },
+  "devDependencies": {
+    "release-it": "^18.1.2",
+    "tsup": "^8.5.1",
+    "vitest": "^4.1.6"
+  }
+}