@aeroswarm/codec 0.0.0-stage → 0.1.9

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

@@ -0,0 +1,16 @@
+export interface AdsbRawFrame {
+    raw: Buffer;
+    receivedAt: number;
+}
+export interface AdsbDecodedFrame {
+    icao24: string;
+    df: number;
+    lat?: number;
+    lon?: number;
+    altitudeFt?: number;
+    groundSpeedKt?: number;
+    headingDeg?: number;
+    callsign?: string;
+}
+export declare function decodeAdsbFrame(_frame: AdsbRawFrame): AdsbDecodedFrame | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/surveillance/adsb/index.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAE7E"}

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/ais/index.d.ts

@@ -0,0 +1,17 @@
+export interface AisRawSentence {
+    raw: string;
+    receivedAt: number;
+}
+export interface AisDecodedMessage {
+    mmsi: string;
+    messageType: number;
+    lat?: number;
+    lon?: number;
+    sog?: number;
+    cog?: number;
+    heading?: number;
+    name?: string;
+    callsign?: string;
+}
+export declare function decodeAis(_sentence: AisRawSentence): AisDecodedMessage | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/surveillance/ais/index.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,cAAc,GAAG,iBAAiB,GAAG,IAAI,CAE7E"}

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

@@ -0,0 +1,14 @@
+export interface AsmgcsRawFrame {
+    raw: Buffer;
+    receivedAt: number;
+}
+export interface AsmgcsDecodedFrame {
+    targetId: string;
+    lat?: number;
+    lon?: number;
+    heading?: number;
+    speed?: number;
+    category?: "aircraft" | "vehicle" | "unknown";
+}
+export declare function decodeAsmgcsFrame(_frame: AsmgcsRawFrame): AsmgcsDecodedFrame | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asmgcs/index.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;CAC/C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,kBAAkB,GAAG,IAAI,CAEnF"}

package/dist/surveillance/asterix/cat10/index.d.ts

@@ -0,0 +1,3 @@
+export type { AsterixRecord, AsterixFields } from "../types.js";
+export { parseAsterix } from "../parser.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/surveillance/asterix/cat10/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/surveillance/asterix/cat21/index.d.ts

@@ -0,0 +1,5 @@
+export type { AsterixRecord, AsterixFields } from "../types.js";
+export { parseAsterix } from "../parser.js";
+export { resolveAsterixPosition, resolveAsterixAltitudeFt } from "../resolvers.js";
+export type { RadarSite } from "../resolvers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/surveillance/asterix/cat21/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/surveillance/asterix/cat48/index.d.ts

@@ -0,0 +1,5 @@
+export type { AsterixRecord, AsterixFields } from "../types.js";
+export { parseAsterix } from "../parser.js";
+export { resolveAsterixPosition, resolveAsterixAltitudeFt } from "../resolvers.js";
+export type { RadarSite } from "../resolvers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/surveillance/asterix/cat48/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/surveillance/asterix/cat62/index.d.ts

@@ -0,0 +1,3 @@
+export type { AsterixRecord, AsterixFields } from "../types.js";
+export { parseAsterix } from "../parser.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/surveillance/asterix/cat62/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { AsterixDef, ItemDef } from './xml-loader.js';
+/** Returns boolean array of data bits (FX bits excluded) and byte length consumed. */
+export declare function parseFspec(buf: Buffer, start?: number): {
+    bits: boolean[];
+    end: number;
+};
+/** Advance offset past one DataItem, returning new offset. */
+export declare function skipItem(buf: Buffer, off: number, def: ItemDef): number;
+/**
+ * Decode one ASTERIX data block (everything after the 3-byte header).
+ * Calls `onField(id, bytes, itemDef)` for each present DataItem.
+ */
+export declare function decodeBlock(block: Buffer, def: AsterixDef, onField: (id: string, data: Buffer, itemDef: ItemDef) => void): void;
+//# sourceMappingURL=decoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/decoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI3D,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAUnF;AAID,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAiDvE;AAID;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAC5D,IAAI,CAyBN"}

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

@@ -0,0 +1,4 @@
+import type { AsterixFields } from './types.js';
+import type { RawValues } from './values.js';
+export declare function decodeKnownField(cat: number, id: string, data: Buffer, out: AsterixFields, raw?: RawValues): void;
+//# sourceMappingURL=fields.d.ts.map

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

@@ -0,0 +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;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/index.d.ts

@@ -0,0 +1,5 @@
+export { parseAsterix } from './parser.js';
+export { resolveAsterixPosition, resolveAsterixAltitudeFt } from './resolvers.js';
+export type { RadarSite } from './resolvers.js';
+export type { AsterixRecord, AsterixFields } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAClF,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { AsterixRecord } from './types.js';
+/**
+ * Parse raw ASTERIX UDP datagram into structured records.
+ *
+ * Strategy:
+ *  1. Parse the ASTERIX frame header (cat, length).
+ *  2. For each category, try editions from latest to oldest.
+ *  3. Accept the first decode that produces plausible coordinates.
+ *  4. If no edition succeeds, the record is dropped silently.
+ *
+ * @param buf            Raw ASTERIX datagram (may contain multiple records)
+ * @param defaultEdition Optional map of category → edition to skip the fallback loop.
+ *                       Use when you know the sender's edition for certainty.
+ */
+export declare function parseAsterix(buf: Buffer, defaultEdition?: Record<number, string>): AsterixRecord[];
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AAsB/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,aAAa,EAAE,CA6CjB"}

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

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

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

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

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

@@ -0,0 +1,17 @@
+import type { AsterixFields } from './types.js';
+export interface RadarSite {
+    lat: number;
+    lon: number;
+}
+/**
+ * Resolve a geodetic position from decoded ASTERIX fields.
+ * - CAT021 / CAT020: direct lat/lon fields
+ * - CAT048: cartesian (NM offset) or polar (range + azimuth) → geodetic via radar site
+ */
+export declare function resolveAsterixPosition(fields: AsterixFields, radarSite?: RadarSite | null): {
+    lat: number;
+    lon: number;
+} | null;
+/** Best altitude (ft) across all category field naming conventions. */
+export declare function resolveAsterixAltitudeFt(fields: AsterixFields): number | undefined;
+//# sourceMappingURL=resolvers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC3B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0BrC;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAElF"}

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

@@ -0,0 +1,56 @@
+export interface AsterixFields {
+    icao24?: string;
+    lat?: number;
+    lon?: number;
+    altitudeFt?: number;
+    callsign?: string;
+    squawk?: string;
+    timeOfDay?: number;
+    velocity?: {
+        groundSpeedKt?: number;
+        headingDeg?: number;
+    };
+    positionCartesian?: {
+        xNm?: number;
+        yNm?: number;
+    };
+    measuredPosition?: {
+        rangeNm?: number;
+        azimuthDeg?: number;
+    };
+    dataSource?: {
+        sac: number;
+        sic: number;
+    };
+    /** I023/000: 1 = ground station status, 2 = service status, 3 = service statistics */
+    reportType?: number;
+    /** I023/100 first octet: nogo=true means data must not be used operationally */
+    gsStatus?: {
+        nogo: boolean;
+        odp: boolean;
+        oxt: boolean;
+        msc: boolean;
+        tsv: boolean;
+        spo: boolean;
+    };
+    /** I023/200: operational range, 1 NM/LSB */
+    operationalRangeNm?: number;
+    /** Surface target classification. "vehicle" when a fleet id is present */
+    targetType?: 'aircraft' | 'vehicle' | 'unknown';
+    /** I010/300 Vehicle Fleet Identification code */
+    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;
+    edition: string;
+    fields: AsterixFields;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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;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/asterix/values.d.ts

@@ -0,0 +1,10 @@
+import type { BitFieldDef } from './xml-loader.js';
+/** Raw named values extracted from one DataItem via its XML <Bits> definitions. */
+export type RawValues = Record<string, number | string>;
+/**
+ * Extract every named bit-field from a DataItem's raw bytes, applying the
+ * signedness, character/octal/hex encoding, and unit scale declared in the XML.
+ * Bit positions are 1-based with 1 = LSB of the last byte (ASTERIX convention).
+ */
+export declare function extractBitFields(data: Buffer, defs: BitFieldDef[]): RawValues;
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAIxD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,CAkD7E"}

package/dist/surveillance/asterix/xml-loader.d.ts

@@ -0,0 +1,46 @@
+/** One named bit-field inside a DataItem, parsed from the XML <Bits> definition.
+ *  Bit positions are 1-based, 1 = LSB of the item's last byte. */
+export interface BitFieldDef {
+    name: string;
+    high: number;
+    low: number;
+    encode: 'unsigned' | 'signed' | '6bitschar' | 'octal' | 'hex' | 'ascii';
+    /** Multiplier from <BitsUnit scale=…>; 1 when absent */
+    scale: number;
+}
+export type FixedDef = {
+    type: 'fixed';
+    bytes: number;
+    bits?: BitFieldDef[];
+};
+export type VariableDef = {
+    type: 'variable';
+    chunkBytes: number;
+    bits?: BitFieldDef[];
+};
+export type RepDef = {
+    type: 'repetitive';
+    repBytes: number;
+    itemBytes: number;
+};
+export type CompoundDef = {
+    type: 'compound';
+    indicatorChunk: number;
+    subs: SubItemDef[];
+};
+export type ExplicitDef = {
+    type: 'explicit';
+};
+export type SubItemDef = FixedDef | VariableDef | RepDef | ExplicitDef;
+export type ItemDef = FixedDef | VariableDef | RepDef | CompoundDef | ExplicitDef;
+export interface UAPEntry {
+    /** FSPEC bit position including FX-placeholder slots (every 8th bit = FX) */
+    bit: number;
+    id: string;
+}
+export interface AsterixDef {
+    uap: UAPEntry[];
+    items: Map<string, ItemDef>;
+}
+export declare function loadDef(cat: number, ed: string): AsterixDef | null;
+//# sourceMappingURL=xml-loader.d.ts.map

package/dist/surveillance/asterix/xml-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-loader.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/xml-loader.ts"],"names":[],"mappings":"AAgBA;kEACkE;AAClE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;IACxE,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,QAAQ,GAAQ;IAAE,IAAI,EAAE,OAAO,CAAC;IAAM,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AACxF,MAAM,MAAM,WAAW,GAAK;IAAE,IAAI,EAAE,UAAU,CAAC;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAC7F,MAAM,MAAM,MAAM,GAAU;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACxF,MAAM,MAAM,WAAW,GAAK;IAAE,IAAI,EAAE,UAAU,CAAC;IAAG,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAC/F,MAAM,MAAM,WAAW,GAAK;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AACjD,MAAM,MAAM,UAAU,GAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAC1E,MAAM,MAAM,OAAO,GAAS,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;AAExF,MAAM,WAAW,QAAQ;IACvB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B;AAgCD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAgBlE"}

package/dist/surveillance/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./asterix/index.js";
+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

@@ -0,0 +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;AAClC,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,16 @@
+export interface MlatRawFrame {
+    raw: Buffer;
+    receivedAt: number;
+    stationId?: string;
+}
+export interface MlatDecodedFrame {
+    icao24: string;
+    lat?: number;
+    lon?: number;
+    altitudeFt?: number;
+    groundSpeedKt?: number;
+    headingDeg?: number;
+    nAirStations?: number;
+}
+export declare function decodeMlatFrame(_frame: MlatRawFrame): MlatDecodedFrame | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/surveillance/mlat/index.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAE7E"}

package/package.json

@@ -1,6 +1,40 @@
-{
-  "name": "@aeroswarm/codec",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "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"
+  }
+}

package/src/config/asterix.dtd

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+        <!--
+
+            DTD for Asterix format
+
+            Author:   dsalantic
+            Created:  24.12.2008.
+            Modified:  28.4.2014. (dsalantic) Removed XIDEF
+            Modified:  16.5.2014. (dsalantic) Nested compound enabled
+                                              Explicit can contain all types
+                       6.7.2016.  (dsalantic) BDS format added
+                       28.11.2016.  (dsalantic) BDS format fixed
+
+        -->
+
+        <!ELEMENT Category (DataItem*,UAP*)>
+        <!ATTLIST Category id CDATA #REQUIRED>
+        <!ATTLIST Category name CDATA #REQUIRED>
+        <!ATTLIST Category ver CDATA #REQUIRED>
+
+        <!ELEMENT Bits (BitsShortName?,BitsName?,(BitsConst|BitsValue*|BitsUnit|BitsPresence))>
+        <!ATTLIST Bits bit CDATA "0">
+        <!ATTLIST Bits from CDATA "0">
+        <!ATTLIST Bits to CDATA "0">
+        <!ATTLIST Bits encode (signed|6bitschar|octal|unsigned|ascii|hex) "unsigned">
+        <!ATTLIST Bits fx CDATA "0">
+        <!ATTLIST Bits rep CDATA "0">
+        <!ELEMENT BitsShortName (#PCDATA)>
+        <!ELEMENT BitsName (#PCDATA)>
+        <!ELEMENT BitsValue (#PCDATA)>
+        <!ATTLIST BitsValue val CDATA "0" >
+        <!-- TODO <!ATTLIST BitsValue from CDATA "0" > -->
+        <!-- TODO <!ATTLIST BitsValue to CDATA "0" > -->
+        <!ELEMENT BitsConst (#PCDATA)>
+        <!ELEMENT BitsPresence (#PCDATA)>
+        <!ELEMENT BitsUnit (#PCDATA)>
+        <!ATTLIST BitsUnit scale CDATA "1" >
+        <!ATTLIST BitsUnit min CDATA "0" >
+        <!ATTLIST BitsUnit max CDATA "0" >
+
+        <!ELEMENT DataItem (DataItemName,DataItemDefinition,DataItemFormat,DataItemNote?)>
+        <!ATTLIST DataItem id CDATA #REQUIRED>
+        <!ATTLIST DataItem rule (mandatory|optional|unknown) "unknown">
+        <!ELEMENT DataItemName (#PCDATA)>
+        <!ELEMENT DataItemDefinition (#PCDATA)>
+        <!ELEMENT DataItemNote (#PCDATA)>
+        <!ELEMENT DataItemFormat (Fixed|Explicit|Repetitive|Variable|Compound|BDS)>
+        <!ATTLIST DataItemFormat desc CDATA "" >
+
+        <!-- Fixed length data fields -->
+        <!ELEMENT Fixed (Bits+)>
+        <!ATTLIST Fixed length CDATA "1" >
+
+        <!-- Explicit length data fields -->
+        <!ELEMENT Explicit (Fixed|Explicit|Repetitive|Variable|Compound)>
+
+        <!-- Repetitive length data fields -->
+        <!ELEMENT Repetitive (Fixed+|BDS)>
+
+        <!-- Variable (extended) length data fields -->
+        <!ELEMENT Variable (Fixed+)>
+
+        <!-- Compund data fields -->
+        <!ELEMENT Compound (Variable,(Fixed|Explicit|Repetitive|Variable|Compound)*)>
+
+        <!-- BDS is defined in asterix_bds.xml -->
+        <!ELEMENT BDS (#PCDATA)>
+
+        <!-- User Application Profile -->
+        <!ELEMENT UAP (UAPItem*)>
+        <!ATTLIST UAP use_if_bit_set CDATA "0">
+        <!ATTLIST UAP use_if_byte_nr CDATA "0">
+        <!ATTLIST UAP is_set_to CDATA "0">
+        <!ELEMENT UAPItem (#PCDATA)>
+        <!ATTLIST UAPItem bit CDATA #REQUIRED>
+        <!ATTLIST UAPItem frn CDATA #REQUIRED>
+        <!ATTLIST UAPItem fx CDATA "0">
+        <!ATTLIST UAPItem len CDATA "-">

package/src/config/asterix.ini

@@ -0,0 +1,17 @@
+asterix_cat010_1_1.xml
+asterix_cat019_1_2.xml
+asterix_cat020_1_7.xml
+asterix_cat021_0_26.xml
+asterix_cat242_1_0.xml
+asterix_cat062_1_16.xml
+asterix_cat063_1_3.xml
+asterix_cat065_1_3.xml
+asterix_cat030_6_2.xml
+asterix_cat031_6_2.xml
+asterix_cat032_6_2.xml
+asterix_cat034_1_26.xml
+asterix_cat252_6_2.xml
+asterix_cat001_1_1.xml
+asterix_cat002_1_0.xml
+asterix_cat048_1_14.xml
+asterix_cat008_1_0.xml