@anthonyfree96/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 comm-scope AndyFree96
+
+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/dist/index.d.ts

@@ -0,0 +1,303 @@
+import { Writable } from 'node:stream';
+
+/** Direction of a piece of traffic relative to the monitored peer. */
+type Direction = 'rx' | 'tx';
+/** The concrete kind of transport a session is bound to. */
+type TransportKind = 'serial' | 'tcp-client' | 'tcp-server' | 'udp' | 'udp-listen';
+/** Static metadata describing the endpoint a session is attached to. */
+interface TransportMeta {
+    kind: TransportKind;
+    /** Stable identifier for this endpoint within a session (e.g. a peer address). */
+    id: string;
+    /** Human-readable, reversible descriptor (e.g. `serial:COM3@115200`). */
+    desc: string;
+}
+/**
+ * A single unit of traffic observed (or replayed) by a {@link DataSource}.
+ * This is the lingua franca between every source and every sink.
+ */
+interface TrafficEvent {
+    /** Epoch milliseconds. */
+    ts: number;
+    dir: Direction;
+    data: Buffer;
+    transport: TransportMeta;
+}
+/** Lifecycle events emitted by a {@link DataSource}. */
+interface SourceEventMap {
+    open: {
+        source: unknown;
+        meta: TransportMeta;
+    };
+    close: {
+        source: unknown;
+        meta: TransportMeta;
+    };
+    error: {
+        source: unknown;
+        error: Error;
+    };
+}
+
+/**
+ * Typed event dispatcher that satisfies the `on`/`off` surface required by
+ * {@link DataSource}. Live transports extend this and simply `emit('data', e)`
+ * when bytes arrive.
+ */
+declare class TrafficBus {
+    private readonly emitter;
+    on(event: 'data', fn: (e: TrafficEvent) => void): void;
+    on<K extends keyof SourceEventMap>(event: K, fn: (e: SourceEventMap[K]) => void): void;
+    off(event: string, fn: (...args: any[]) => void): void;
+    protected emitData(e: TrafficEvent): void;
+    protected emit<K extends keyof SourceEventMap>(event: K, payload: SourceEventMap[K]): void;
+}
+
+/**
+ * A stream of {@link TrafficEvent}s. Implemented by both live transports
+ * (Serial/TCP/UDP) and offline sources (a recording file being played back),
+ * so the presentation and sink layers never need to know which they have.
+ */
+interface DataSource {
+    /** Begin producing events. */
+    start(): Promise<void>;
+    /** Stop producing events and release resources. */
+    stop(): Promise<void>;
+    /** Subscribe to traffic. */
+    on(event: 'data', fn: (e: TrafficEvent) => void): void;
+    /** Subscribe to a lifecycle event. */
+    on<K extends keyof SourceEventMap>(event: K, fn: (e: SourceEventMap[K]) => void): void;
+    /** Unsubscribe a previously registered listener. */
+    off(event: string, fn: (...args: any[]) => void): void;
+}
+
+/**
+ * A live transport: a {@link DataSource} that additionally allows writing
+ * bytes to the peer (used by the online-replay path to re-send recorded data).
+ */
+interface Transport extends DataSource {
+    /** Write bytes to the peer. Resolves once handed to the underlying channel. */
+    send(data: Buffer): Promise<void>;
+}
+
+/**
+ * A consumer of the traffic stream. Sinks are composable: a single session can
+ * feed a live renderer, a recorder and an analyzer simultaneously, and future
+ * GUI frontends become just another sink implementation.
+ */
+interface Sink {
+    /** Called for every event that passes any upstream filter. */
+    onEvent(e: TrafficEvent): void;
+    /** Called once when the source stops or the session ends. */
+    onClose(): void;
+}
+
+/**
+ * Formatting helpers shared by the CLI renderers (and reusable by a future GUI).
+ * Everything here is pure: `Buffer` in, string out.
+ */
+/** Lowercase hex of every byte, space-separated. */
+declare function toHex(buf: Buffer): string;
+/** Printable ASCII where possible, `.` otherwise. */
+declare function toAscii(buf: Buffer): string;
+interface HexDumpLine {
+    /** 8-digit zero-padded hex offset. */
+    offset: string;
+    hex: string;
+    ascii: string;
+}
+/**
+ * Classic `xxd`-style dump, grouped 8 bytes / 16 bytes per row, with an
+ * ASCII gutter. Returns one object per row.
+ */
+declare function hexdump(buf: Buffer, bytesPerRow?: number): HexDumpLine[];
+
+/**
+ * Parsed form of a transport spec string such as `tcp-listen:9000`.
+ * Reversible: {@link toDesc} regenerates the canonical spec.
+ */
+type TransportSpec = {
+    kind: 'serial';
+    port: string;
+    baud: number;
+} | {
+    kind: 'tcp-client';
+    host: string;
+    port: number;
+} | {
+    kind: 'tcp-server';
+    host: string;
+    port: number;
+} | {
+    kind: 'udp';
+    host: string;
+    port: number;
+} | {
+    kind: 'udp-listen';
+    host: string;
+    port: number;
+};
+/** Parse a transport spec string into its structured form. */
+declare function parseSpec(spec: string): TransportSpec;
+/** Canonical, reversible descriptor for a spec. */
+declare function toDesc(spec: TransportSpec): string;
+/** Construct the concrete {@link Transport} for a parsed spec. */
+declare function createTransport(spec: TransportSpec): Transport;
+
+declare const DEFAULT_BAUD = 115200;
+/** Enumerate attached serial ports. */
+declare function listSerialPorts(): Promise<{
+    path: string;
+    manufacturer?: string;
+}[]>;
+
+/** Parse a hex string (spaces and `0x` tolerated) into a Buffer. */
+declare function hexToBuffer(s: string): Buffer;
+interface FilterOptions {
+    /** Only pass events in this direction. */
+    dir?: Direction;
+    /** Byte-sequence match against the raw payload. */
+    hex?: Buffer;
+    /** Literal (UTF-8) substring match against the raw payload. */
+    string?: Buffer;
+    /** Regex matched against the UTF-8-decoded payload. */
+    regex?: RegExp;
+}
+/**
+ * Per-event predicate. All specified criteria must pass for an event to be
+ * forwarded to sinks. Note this matches within a single event; stream-level
+ * patterns that span event boundaries belong to the search/analysis layer.
+ */
+declare class Matcher {
+    private readonly opts;
+    constructor(opts: FilterOptions);
+    matches(e: TrafficEvent): boolean;
+}
+
+interface SessionOptions {
+    filter?: Matcher;
+    sinks?: Sink[];
+}
+/**
+ * Wires a {@link DataSource} to a set of sinks, applying an optional filter.
+ * This is the shared glue behind `monitor`, `view` and `replay`: the source is
+ * swapped (live transport vs recording file), the sink graph stays the same.
+ */
+declare class Session {
+    private readonly source;
+    private readonly opts;
+    private readonly sinks;
+    private finished;
+    constructor(source: DataSource, opts?: SessionOptions);
+    run(): Promise<void>;
+    private dispatch;
+    private finish;
+    stop(): Promise<void>;
+}
+
+/**
+ * JSON Lines recording format.
+ *
+ * First line is a header carrying a magic key (`comm-scope`) plus the schema
+ * version and session metadata. Every following line is a single traffic
+ * event, payload encoded as lowercase hex so binary data round-trips cleanly
+ * through JSON without escaping concerns.
+ */
+declare const SCHEMA_VERSION = 1;
+declare const MAGIC_KEY = "comm-scope";
+interface SessionHeader {
+    version: number;
+    kind: TransportKind;
+    id: string;
+    desc: string;
+    started: number;
+}
+declare function encodeHeader(h: SessionHeader): string;
+declare function decodeHeader(line: string): SessionHeader;
+declare function encodeEvent(e: TrafficEvent): string;
+declare function decodeEvent(line: string): TrafficEvent;
+
+/**
+ * Writes traffic as JSON Lines. Owns the target stream: it writes the header
+ * immediately and ends the stream when the session closes.
+ */
+declare class JsonlRecorder implements Sink {
+    private readonly stream;
+    private readonly header;
+    constructor(stream: Writable, header: SessionHeader);
+    onEvent(e: TrafficEvent): void;
+    onClose(): void;
+}
+
+interface FileSourceOptions {
+    /** Replay speed multiplier. 1 = real-time, 0 = as fast as possible. */
+    speed?: number;
+    /** Optional direction filter applied while reading. */
+    dir?: Direction;
+}
+/**
+ * Offline data source: reads a recording and re-emits its events at the
+ * original timing (scaled by `speed`). Swappable for any live transport, which
+ * is what makes `view` behave identically to `monitor`.
+ */
+declare class FileSource extends TrafficBus implements DataSource {
+    private readonly file;
+    private readonly opts;
+    private stopped;
+    private rl;
+    private readonly meta;
+    constructor(file: string, opts?: FileSourceOptions);
+    start(): Promise<void>;
+    private headerMeta;
+    stop(): Promise<void>;
+}
+
+interface TrafficStats {
+    firstTs: number;
+    lastTs: number;
+    rxBytes: number;
+    txBytes: number;
+    rxPackets: number;
+    txPackets: number;
+}
+interface TrafficSummary extends TrafficStats {
+    durationMs: number;
+    rxRate: number;
+    txRate: number;
+    totalRate: number;
+}
+/**
+ * Accumulates byte/packet counters and rates. Attach alongside a renderer or
+ * recorder; call {@link summarize} when the session ends.
+ */
+declare class Analyzer implements Sink {
+    private firstTs;
+    private lastTs;
+    private rxBytes;
+    private txBytes;
+    private rxPackets;
+    private txPackets;
+    onEvent(e: TrafficEvent): void;
+    onClose(): void;
+    summarize(): TrafficSummary;
+}
+
+/** Read a recording's events into memory, optionally filtering by direction. */
+declare function readEvents(file: string, dir?: Direction): Promise<TrafficEvent[]>;
+interface ReplayOptions {
+    /** Replay speed multiplier. 1 = real-time, 0 = as fast as possible. */
+    speed?: number;
+    /** Only replay events in this direction. Defaults to all. */
+    dir?: Direction;
+    /** Re-send continuously until interrupted. */
+    loop?: boolean;
+    /** Progress callback, fired once per event sent. */
+    onProgress?: (sent: number, total: number) => void;
+}
+/**
+ * Re-send a recording's bytes to a live transport at the original timing.
+ * Resolves once finished (never, when `loop` is set — interrupt externally).
+ */
+declare function replayFileToTransport(file: string, target: Transport, opts?: ReplayOptions): Promise<number>;
+
+export { Analyzer, DEFAULT_BAUD, type DataSource, type Direction, FileSource, type FileSourceOptions, type FilterOptions, type HexDumpLine, JsonlRecorder, MAGIC_KEY, Matcher, type ReplayOptions, SCHEMA_VERSION, Session, type SessionHeader, type SessionOptions, type Sink, type SourceEventMap, TrafficBus, type TrafficEvent, type TrafficStats, type TrafficSummary, type Transport, type TransportKind, type TransportMeta, type TransportSpec, createTransport, decodeEvent, decodeHeader, encodeEvent, encodeHeader, hexToBuffer, hexdump, listSerialPorts, parseSpec, readEvents, replayFileToTransport, toAscii, toDesc, toHex };

package/dist/index.js

@@ -0,0 +1,722 @@
+// src/event/bus.ts
+import { EventEmitter } from "events";
+var TrafficBus = class {
+  emitter = new EventEmitter();
+  on(event, fn) {
+    this.emitter.on(event, fn);
+  }
+  off(event, fn) {
+    this.emitter.off(event, fn);
+  }
+  emitData(e) {
+    this.emitter.emit("data", e);
+  }
+  emit(event, payload) {
+    this.emitter.emit(event, payload);
+  }
+};
+
+// src/format/hexdump.ts
+var HEX = "0123456789abcdef";
+function hexByte(b) {
+  return HEX[b >> 4 & 15] + HEX[b & 15];
+}
+function toHex(buf) {
+  let out = "";
+  for (let i = 0; i < buf.length; i++) {
+    if (i > 0) out += " ";
+    out += hexByte(buf[i]);
+  }
+  return out;
+}
+function toAscii(buf) {
+  let out = "";
+  for (let i = 0; i < buf.length; i++) {
+    const c = buf[i];
+    out += c >= 32 && c <= 126 ? String.fromCharCode(c) : ".";
+  }
+  return out;
+}
+function hexdump(buf, bytesPerRow = 16) {
+  const lines = [];
+  for (let base = 0; base < buf.length; base += bytesPerRow) {
+    const row = buf.subarray(base, base + bytesPerRow);
+    const hexParts = [];
+    let ascii = "";
+    for (let i = 0; i < row.length; i++) {
+      hexParts.push(hexByte(row[i]));
+      if (i === 7) hexParts.push(" ");
+      ascii += toAscii(row.subarray(i, i + 1));
+    }
+    const targetHex = bytesPerRow * 2 + Math.floor(bytesPerRow / 8);
+    const hex = hexParts.join(" ").padEnd(targetHex, " ");
+    lines.push({
+      offset: base.toString(16).padStart(8, "0"),
+      hex,
+      ascii
+    });
+  }
+  return lines;
+}
+
+// src/transport/tcp.ts
+import net from "net";
+var TcpClientTransport = class extends TrafficBus {
+  constructor(host, port) {
+    super();
+    this.host = host;
+    this.port = port;
+    this.meta = {
+      kind: "tcp-client",
+      id: `${host}:${port}`,
+      desc: `tcp:${host}:${port}`
+    };
+  }
+  host;
+  port;
+  socket;
+  meta;
+  async start() {
+    const socket = net.createConnection({ host: this.host, port: this.port });
+    this.socket = socket;
+    await new Promise((resolve, reject) => {
+      socket.once("connect", resolve);
+      socket.once("error", reject);
+    });
+    socket.on("data", (data) => this.onRx(data));
+    socket.on("close", () => this.emit("close", { source: this, meta: this.meta }));
+    socket.on("error", (err) => this.emit("error", { source: this, error: err }));
+    this.emit("open", { source: this, meta: this.meta });
+  }
+  onRx(data) {
+    const e = { ts: Date.now(), dir: "rx", data, transport: this.meta };
+    this.emitData(e);
+  }
+  async send(data) {
+    const socket = this.socket;
+    if (!socket) throw new Error("tcp-client: not connected");
+    await new Promise((resolve, reject) => {
+      socket.write(data, (err) => err ? reject(err) : resolve());
+    });
+    const e = { ts: Date.now(), dir: "tx", data, transport: this.meta };
+    this.emitData(e);
+  }
+  async stop() {
+    this.socket?.destroy();
+    this.socket = void 0;
+  }
+};
+var TcpServerTransport = class extends TrafficBus {
+  constructor(host, port) {
+    super();
+    this.host = host;
+    this.port = port;
+  }
+  host;
+  port;
+  server;
+  sockets = /* @__PURE__ */ new Map();
+  async start() {
+    await new Promise((resolve, reject) => {
+      const server = net.createServer((socket) => this.onConnection(socket));
+      server.once("error", reject);
+      server.listen(this.port, this.host || void 0, () => {
+        server.off("error", reject);
+        resolve();
+      });
+      this.server = server;
+    });
+    const meta = {
+      kind: "tcp-server",
+      id: `${this.host || "0.0.0.0"}:${this.port}`,
+      desc: `tcp-listen:${this.host ? `${this.host}:` : ""}${this.port}`
+    };
+    this.emit("open", { source: this, meta });
+  }
+  onConnection(socket) {
+    const remote = `${socket.remoteAddress ?? "?"}:${socket.remotePort ?? "?"}`;
+    const meta = {
+      kind: "tcp-server",
+      id: remote,
+      desc: `tcp-listen:${this.port}#${remote}`
+    };
+    this.sockets.set(remote, socket);
+    socket.on("data", (data) => {
+      const e = { ts: Date.now(), dir: "rx", data, transport: meta };
+      this.emitData(e);
+    });
+    socket.on("close", () => this.sockets.delete(remote));
+    socket.on("error", (err) => this.emit("error", { source: this, error: err }));
+  }
+  async send(data) {
+    const writes = [];
+    for (const socket of this.sockets.values()) {
+      writes.push(
+        new Promise((resolve, reject) => {
+          socket.write(data, (err) => err ? reject(err) : resolve());
+        })
+      );
+    }
+    await Promise.all(writes);
+  }
+  async stop() {
+    for (const socket of this.sockets.values()) socket.destroy();
+    this.sockets.clear();
+    await new Promise((resolve) => {
+      if (!this.server) return resolve();
+      this.server.close(() => resolve());
+    });
+    this.server = void 0;
+  }
+};
+
+// src/transport/udp.ts
+import dgram from "dgram";
+function udpTypeFor(host) {
+  return host.includes(":") ? "udp6" : "udp4";
+}
+var UdpTransport = class extends TrafficBus {
+  constructor(host, port) {
+    super();
+    this.host = host;
+    this.port = port;
+    this.meta = { kind: "udp", id: `${host}:${port}`, desc: `udp:${host}:${port}` };
+  }
+  host;
+  port;
+  socket;
+  meta;
+  async start() {
+    const socket = dgram.createSocket(udpTypeFor(this.host));
+    this.socket = socket;
+    await new Promise((resolve, reject) => {
+      socket.once("error", reject);
+      socket.bind(0, () => {
+        socket.off("error", reject);
+        resolve();
+      });
+    });
+    socket.on("message", (msg, rinfo) => {
+      if (rinfo.address !== this.host || rinfo.port !== this.port) return;
+      const e = { ts: Date.now(), dir: "rx", data: msg, transport: this.meta };
+      this.emitData(e);
+    });
+    socket.on("error", (err) => this.emit("error", { source: this, error: err }));
+    this.emit("open", { source: this, meta: this.meta });
+  }
+  async send(data) {
+    const socket = this.socket;
+    if (!socket) throw new Error("udp: not bound");
+    await new Promise((resolve, reject) => {
+      socket.send(data, this.port, this.host, (err) => err ? reject(err) : resolve());
+    });
+    const e = { ts: Date.now(), dir: "tx", data, transport: this.meta };
+    this.emitData(e);
+  }
+  async stop() {
+    await new Promise((resolve) => {
+      if (!this.socket) return resolve();
+      this.socket.close(() => resolve());
+    });
+    this.socket = void 0;
+  }
+};
+var UdpListenTransport = class extends TrafficBus {
+  constructor(host, port) {
+    super();
+    this.host = host;
+    this.port = port;
+    const label = `${this.host || "0.0.0.0"}:${this.port}`;
+    this.meta = { kind: "udp-listen", id: label, desc: `udp-listen:${label}` };
+  }
+  host;
+  port;
+  socket;
+  lastPeer;
+  meta;
+  async start() {
+    const socket = dgram.createSocket(udpTypeFor(this.host));
+    this.socket = socket;
+    await new Promise((resolve, reject) => {
+      socket.once("error", reject);
+      socket.bind(this.port, this.host || void 0, () => {
+        socket.off("error", reject);
+        resolve();
+      });
+    });
+    socket.on("message", (msg, rinfo) => {
+      this.lastPeer = { address: rinfo.address, port: rinfo.port };
+      const meta = {
+        kind: "udp-listen",
+        id: `${rinfo.address}:${rinfo.port}`,
+        desc: this.meta.desc
+      };
+      const e = { ts: Date.now(), dir: "rx", data: msg, transport: meta };
+      this.emitData(e);
+    });
+    socket.on("error", (err) => this.emit("error", { source: this, error: err }));
+    this.emit("open", { source: this, meta: this.meta });
+  }
+  async send(data) {
+    const socket = this.socket;
+    const peer = this.lastPeer;
+    if (!socket) throw new Error("udp-listen: not bound");
+    if (!peer) throw new Error("udp-listen: no peer has sent yet");
+    await new Promise((resolve, reject) => {
+      socket.send(data, peer.port, peer.address, (err) => err ? reject(err) : resolve());
+    });
+  }
+  async stop() {
+    await new Promise((resolve) => {
+      if (!this.socket) return resolve();
+      this.socket.close(() => resolve());
+    });
+    this.socket = void 0;
+  }
+};
+
+// src/transport/serial.ts
+import { SerialPort } from "serialport";
+var DEFAULT_BAUD = 115200;
+var SerialTransport = class extends TrafficBus {
+  constructor(path, baud) {
+    super();
+    this.path = path;
+    this.baud = baud;
+    this.meta = { kind: "serial", id: path, desc: `serial:${path}:${baud}` };
+  }
+  path;
+  baud;
+  port;
+  meta;
+  async start() {
+    const port = new SerialPort({ path: this.path, baudRate: this.baud });
+    this.port = port;
+    await new Promise((resolve, reject) => {
+      port.once("open", resolve);
+      port.once("error", reject);
+    });
+    port.on("data", (data) => {
+      const e = { ts: Date.now(), dir: "rx", data, transport: this.meta };
+      this.emitData(e);
+    });
+    port.on("close", () => this.emit("close", { source: this, meta: this.meta }));
+    port.on("error", (err) => this.emit("error", { source: this, error: err }));
+    this.emit("open", { source: this, meta: this.meta });
+  }
+  async send(data) {
+    if (!this.port) throw new Error("serial: not open");
+    await new Promise((resolve, reject) => {
+      this.port.write(data, (err) => err ? reject(err) : resolve());
+    });
+    const e = { ts: Date.now(), dir: "tx", data, transport: this.meta };
+    this.emitData(e);
+  }
+  async stop() {
+    if (!this.port) return;
+    const port = this.port;
+    this.port = void 0;
+    await new Promise((resolve) => port.close(() => resolve()));
+  }
+};
+async function listSerialPorts() {
+  const ports = await SerialPort.list();
+  return ports.map((p) => ({ path: p.path, manufacturer: p.manufacturer }));
+}
+
+// src/transport/factory.ts
+function parsePort(s) {
+  if (!/^\d+$/.test(s)) throw new Error(`invalid port "${s}"`);
+  const p = Number(s);
+  if (p < 1 || p > 65535) throw new Error(`port out of range "${s}"`);
+  return p;
+}
+function parseBaud(s) {
+  if (!/^\d+$/.test(s)) throw new Error(`invalid baud "${s}"`);
+  const b = Number(s);
+  if (b < 1) throw new Error(`invalid baud "${s}"`);
+  return b;
+}
+function splitHostPort(s) {
+  let host;
+  let portStr;
+  if (s.startsWith("[")) {
+    const close = s.indexOf("]");
+    if (close < 0) throw new Error(`invalid host:port "${s}"`);
+    host = s.slice(1, close);
+    portStr = s.slice(close + 1);
+    if (!portStr.startsWith(":")) throw new Error(`invalid host:port "${s}"`);
+    portStr = portStr.slice(1);
+  } else {
+    const i = s.lastIndexOf(":");
+    if (i < 0) throw new Error(`missing port in "${s}"`);
+    host = s.slice(0, i);
+    portStr = s.slice(i + 1);
+  }
+  return { host, port: parsePort(portStr) };
+}
+function splitListen(s) {
+  if (!s.includes(":")) return { host: "", port: parsePort(s) };
+  return splitHostPort(s);
+}
+function splitSerial(s) {
+  const parts = s.split(":");
+  if (parts.length >= 2 && /^\d+$/.test(parts[1])) {
+    return { path: parts[0], baud: parseBaud(parts[1]) };
+  }
+  return { path: s, baud: DEFAULT_BAUD };
+}
+function parseSpec(spec) {
+  const idx = spec.indexOf(":");
+  if (idx < 0) throw new Error(`invalid transport spec "${spec}" (expected "scheme:...")`);
+  const scheme = spec.slice(0, idx);
+  const rest = spec.slice(idx + 1);
+  switch (scheme) {
+    case "serial": {
+      const { path, baud } = splitSerial(rest);
+      return { kind: "serial", port: path, baud };
+    }
+    case "tcp": {
+      const { host, port } = splitHostPort(rest);
+      return { kind: "tcp-client", host, port };
+    }
+    case "tcp-listen": {
+      const { host, port } = splitListen(rest);
+      return { kind: "tcp-server", host, port };
+    }
+    case "udp": {
+      const { host, port } = splitHostPort(rest);
+      return { kind: "udp", host, port };
+    }
+    case "udp-listen": {
+      const { host, port } = splitListen(rest);
+      return { kind: "udp-listen", host, port };
+    }
+    default:
+      throw new Error(`unknown transport scheme "${scheme}"`);
+  }
+}
+function toDesc(spec) {
+  switch (spec.kind) {
+    case "serial":
+      return `serial:${spec.port}:${spec.baud}`;
+    case "tcp-client":
+      return `tcp:${spec.host}:${spec.port}`;
+    case "tcp-server":
+      return `tcp-listen:${spec.host ? `${spec.host}:` : ""}${spec.port}`;
+    case "udp":
+      return `udp:${spec.host}:${spec.port}`;
+    case "udp-listen":
+      return `udp-listen:${spec.host ? `${spec.host}:` : ""}${spec.port}`;
+  }
+}
+function createTransport(spec) {
+  switch (spec.kind) {
+    case "serial":
+      return new SerialTransport(spec.port, spec.baud);
+    case "tcp-client":
+      return new TcpClientTransport(spec.host, spec.port);
+    case "tcp-server":
+      return new TcpServerTransport(spec.host, spec.port);
+    case "udp":
+      return new UdpTransport(spec.host, spec.port);
+    case "udp-listen":
+      return new UdpListenTransport(spec.host, spec.port);
+  }
+}
+
+// src/sink/filter.ts
+function hexToBuffer(s) {
+  const clean = s.replace(/0x/gi, "").replace(/[\s,]/g, "");
+  if (clean.length % 2 !== 0) throw new Error(`hex string has odd length: "${s}"`);
+  if (!/^[0-9a-f]*$/i.test(clean)) throw new Error(`invalid hex string: "${s}"`);
+  const buf = Buffer.alloc(clean.length / 2);
+  for (let i = 0; i < buf.length; i++) buf[i] = parseInt(clean.slice(i * 2, i * 2 + 2), 16);
+  return buf;
+}
+var Matcher = class {
+  constructor(opts) {
+    this.opts = opts;
+  }
+  opts;
+  matches(e) {
+    if (this.opts.dir && e.dir !== this.opts.dir) return false;
+    if (this.opts.hex && !e.data.includes(this.opts.hex)) return false;
+    if (this.opts.string && !e.data.includes(this.opts.string)) return false;
+    if (this.opts.regex && !this.opts.regex.test(e.data.toString("utf8"))) return false;
+    return true;
+  }
+};
+
+// src/session.ts
+var Session = class {
+  constructor(source, opts = {}) {
+    this.source = source;
+    this.opts = opts;
+    this.sinks = opts.sinks ?? [];
+  }
+  source;
+  opts;
+  sinks;
+  finished = false;
+  async run() {
+    this.source.on("data", (e) => this.dispatch(e));
+    this.source.on("close", () => this.finish());
+    await this.source.start();
+  }
+  dispatch(e) {
+    if (this.opts.filter && !this.opts.filter.matches(e)) return;
+    for (const sink of this.sinks) sink.onEvent(e);
+  }
+  finish() {
+    if (this.finished) return;
+    this.finished = true;
+    for (const sink of this.sinks) sink.onClose();
+  }
+  async stop() {
+    await this.source.stop();
+    this.finish();
+  }
+};
+
+// src/format/jsonl.ts
+var SCHEMA_VERSION = 1;
+var MAGIC_KEY = "comm-scope";
+function encodeHeader(h) {
+  return JSON.stringify({
+    [MAGIC_KEY]: h.version,
+    kind: h.kind,
+    id: h.id,
+    desc: h.desc,
+    started: h.started
+  });
+}
+function decodeHeader(line) {
+  const o = JSON.parse(line);
+  const version = o[MAGIC_KEY];
+  if (typeof version !== "number") {
+    throw new Error("not a comm-scope recording (missing header)");
+  }
+  if (version !== SCHEMA_VERSION) {
+    throw new Error(`unsupported recording schema version ${version}`);
+  }
+  return {
+    version,
+    kind: o.kind,
+    id: String(o.id ?? ""),
+    desc: String(o.desc ?? ""),
+    started: Number(o.started ?? 0)
+  };
+}
+function encodeEvent(e) {
+  return JSON.stringify({
+    t: e.ts,
+    dir: e.dir,
+    kind: e.transport.kind,
+    id: e.transport.id,
+    desc: e.transport.desc,
+    enc: "hex",
+    data: e.data.toString("hex")
+  });
+}
+function decodeEvent(line) {
+  const o = JSON.parse(line);
+  if (o.enc !== "hex") throw new Error(`unsupported payload encoding "${String(o.enc)}"`);
+  const dir = o.dir;
+  if (dir !== "rx" && dir !== "tx") throw new Error(`invalid direction "${String(o.dir)}"`);
+  return {
+    ts: Number(o.t),
+    dir,
+    data: Buffer.from(String(o.data), "hex"),
+    transport: {
+      kind: o.kind,
+      id: String(o.id ?? ""),
+      desc: String(o.desc ?? "")
+    }
+  };
+}
+
+// src/sink/recorder.ts
+var JsonlRecorder = class {
+  constructor(stream, header) {
+    this.stream = stream;
+    this.header = header;
+    this.stream.write(encodeHeader(header) + "\n");
+  }
+  stream;
+  header;
+  onEvent(e) {
+    this.stream.write(encodeEvent(e) + "\n");
+  }
+  onClose() {
+    this.stream.end();
+  }
+};
+
+// src/source/file-source.ts
+import fs from "fs";
+import readline from "readline";
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var FileSource = class extends TrafficBus {
+  constructor(file, opts = {}) {
+    super();
+    this.file = file;
+    this.opts = opts;
+    this.meta = { kind: "serial", id: file, desc: file };
+  }
+  file;
+  opts;
+  stopped = false;
+  rl;
+  meta;
+  async start() {
+    this.stopped = false;
+    const rl = readline.createInterface({
+      input: fs.createReadStream(this.file),
+      crlfDelay: Infinity
+    });
+    this.rl = rl;
+    const speed = this.opts.speed ?? 1;
+    let prevT;
+    let header;
+    try {
+      for await (const line of rl) {
+        if (this.stopped) break;
+        if (header === void 0) {
+          header = decodeHeader(line);
+          this.emit("open", { source: this, meta: this.headerMeta(header) });
+          continue;
+        }
+        const e = decodeEvent(line);
+        if (this.opts.dir && e.dir !== this.opts.dir) continue;
+        if (prevT !== void 0 && speed > 0) {
+          const wait = (e.ts - prevT) / speed;
+          if (wait > 0) await sleep(wait);
+        }
+        prevT = e.ts;
+        this.emitData(e);
+      }
+    } finally {
+      if (!this.stopped) {
+        this.emit("close", { source: this, meta: this.meta });
+      }
+    }
+  }
+  headerMeta(h) {
+    return { kind: h.kind, id: h.id, desc: h.desc };
+  }
+  async stop() {
+    this.stopped = true;
+    this.rl?.close();
+  }
+};
+
+// src/sink/analyzer.ts
+var Analyzer = class {
+  firstTs = 0;
+  lastTs = 0;
+  rxBytes = 0;
+  txBytes = 0;
+  rxPackets = 0;
+  txPackets = 0;
+  onEvent(e) {
+    if (this.firstTs === 0) this.firstTs = e.ts;
+    this.lastTs = e.ts;
+    if (e.dir === "rx") {
+      this.rxBytes += e.data.length;
+      this.rxPackets++;
+    } else {
+      this.txBytes += e.data.length;
+      this.txPackets++;
+    }
+  }
+  onClose() {
+  }
+  summarize() {
+    const durationMs = Math.max(0, this.lastTs - this.firstTs);
+    const secs = durationMs / 1e3 || 1;
+    return {
+      firstTs: this.firstTs,
+      lastTs: this.lastTs,
+      rxBytes: this.rxBytes,
+      txBytes: this.txBytes,
+      rxPackets: this.rxPackets,
+      txPackets: this.txPackets,
+      durationMs,
+      rxRate: this.rxBytes / secs,
+      txRate: this.txBytes / secs,
+      totalRate: (this.rxBytes + this.txBytes) / secs
+    };
+  }
+};
+
+// src/replay/replay.ts
+import fs2 from "fs";
+import readline2 from "readline";
+var sleep2 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function readEvents(file, dir) {
+  const events = [];
+  const rl = readline2.createInterface({
+    input: fs2.createReadStream(file),
+    crlfDelay: Infinity
+  });
+  let headerSeen = false;
+  for await (const line of rl) {
+    if (!headerSeen) {
+      decodeHeader(line);
+      headerSeen = true;
+      continue;
+    }
+    const e = decodeEvent(line);
+    if (dir && e.dir !== dir) continue;
+    events.push(e);
+  }
+  return events;
+}
+async function replayFileToTransport(file, target, opts = {}) {
+  const events = await readEvents(file, opts.dir);
+  const speed = opts.speed ?? 1;
+  const total = events.length;
+  let sent = 0;
+  for (; ; ) {
+    let prevT;
+    for (const e of events) {
+      if (prevT !== void 0 && speed > 0) {
+        const wait = (e.ts - prevT) / speed;
+        if (wait > 0) await sleep2(wait);
+      }
+      prevT = e.ts;
+      await target.send(e.data);
+      sent++;
+      opts.onProgress?.(sent, total);
+    }
+    if (!opts.loop) break;
+  }
+  return sent;
+}
+export {
+  Analyzer,
+  DEFAULT_BAUD,
+  FileSource,
+  JsonlRecorder,
+  MAGIC_KEY,
+  Matcher,
+  SCHEMA_VERSION,
+  Session,
+  TrafficBus,
+  createTransport,
+  decodeEvent,
+  decodeHeader,
+  encodeEvent,
+  encodeHeader,
+  hexToBuffer,
+  hexdump,
+  listSerialPorts,
+  parseSpec,
+  readEvents,
+  replayFileToTransport,
+  toAscii,
+  toDesc,
+  toHex
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event/bus.ts","../src/format/hexdump.ts","../src/transport/tcp.ts","../src/transport/udp.ts","../src/transport/serial.ts","../src/transport/factory.ts","../src/sink/filter.ts","../src/session.ts","../src/format/jsonl.ts","../src/sink/recorder.ts","../src/source/file-source.ts","../src/sink/analyzer.ts","../src/replay/replay.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport type { TrafficEvent, SourceEventMap } from './events.js';\n\n/**\n * Typed event dispatcher that satisfies the `on`/`off` surface required by\n * {@link DataSource}. Live transports extend this and simply `emit('data', e)`\n * when bytes arrive.\n */\nexport class TrafficBus {\n  private readonly emitter = new EventEmitter();\n\n  on(event: 'data', fn: (e: TrafficEvent) => void): void;\n  on<K extends keyof SourceEventMap>(event: K, fn: (e: SourceEventMap[K]) => void): void;\n  on(event: string, fn: (...args: any[]) => void): void {\n    this.emitter.on(event, fn);\n  }\n\n  off(event: string, fn: (...args: any[]) => void): void {\n    this.emitter.off(event, fn);\n  }\n\n  protected emitData(e: TrafficEvent): void {\n    this.emitter.emit('data', e);\n  }\n\n  protected emit<K extends keyof SourceEventMap>(\n    event: K,\n    payload: SourceEventMap[K],\n  ): void {\n    this.emitter.emit(event, payload);\n  }\n}\n","/**\n * Formatting helpers shared by the CLI renderers (and reusable by a future GUI).\n * Everything here is pure: `Buffer` in, string out.\n */\n\nconst HEX = '0123456789abcdef';\n\nfunction hexByte(b: number): string {\n  return HEX[(b >> 4) & 0xf]! + HEX[b & 0xf]!;\n}\n\n/** Lowercase hex of every byte, space-separated. */\nexport function toHex(buf: Buffer): string {\n  let out = '';\n  for (let i = 0; i < buf.length; i++) {\n    if (i > 0) out += ' ';\n    out += hexByte(buf[i]!);\n  }\n  return out;\n}\n\n/** Printable ASCII where possible, `.` otherwise. */\nexport function toAscii(buf: Buffer): string {\n  let out = '';\n  for (let i = 0; i < buf.length; i++) {\n    const c = buf[i]!;\n    out += c >= 0x20 && c <= 0x7e ? String.fromCharCode(c) : '.';\n  }\n  return out;\n}\n\nexport interface HexDumpLine {\n  /** 8-digit zero-padded hex offset. */\n  offset: string;\n  hex: string;\n  ascii: string;\n}\n\n/**\n * Classic `xxd`-style dump, grouped 8 bytes / 16 bytes per row, with an\n * ASCII gutter. Returns one object per row.\n */\nexport function hexdump(buf: Buffer, bytesPerRow = 16): HexDumpLine[] {\n  const lines: HexDumpLine[] = [];\n  for (let base = 0; base < buf.length; base += bytesPerRow) {\n    const row = buf.subarray(base, base + bytesPerRow);\n    const hexParts: string[] = [];\n    let ascii = '';\n    for (let i = 0; i < row.length; i++) {\n      hexParts.push(hexByte(row[i]!));\n      if (i === 7) hexParts.push(' '); // visual gap after byte 7\n      ascii += toAscii(row.subarray(i, i + 1));\n    }\n    // Pad the hex column so every row lines up.\n    const targetHex = bytesPerRow * 2 + Math.floor(bytesPerRow / 8);\n    const hex = hexParts.join(' ').padEnd(targetHex, ' ');\n    lines.push({\n      offset: base.toString(16).padStart(8, '0'),\n      hex,\n      ascii,\n    });\n  }\n  return lines;\n}\n","import net from 'node:net';\nimport type { TrafficEvent, TransportMeta } from '../event/events.js';\nimport { TrafficBus } from '../event/bus.js';\nimport type { Transport } from './transport.js';\n\n/** Outbound TCP client: connects to `host:port` and monitors the stream. */\nexport class TcpClientTransport extends TrafficBus implements Transport {\n  private socket: net.Socket | undefined;\n  private readonly meta: TransportMeta;\n\n  constructor(\n    private readonly host: string,\n    private readonly port: number,\n  ) {\n    super();\n    this.meta = {\n      kind: 'tcp-client',\n      id: `${host}:${port}`,\n      desc: `tcp:${host}:${port}`,\n    };\n  }\n\n  async start(): Promise<void> {\n    const socket = net.createConnection({ host: this.host, port: this.port });\n    this.socket = socket;\n    await new Promise<void>((resolve, reject) => {\n      socket.once('connect', resolve);\n      socket.once('error', reject);\n    });\n    socket.on('data', (data: Buffer) => this.onRx(data));\n    socket.on('close', () => this.emit('close', { source: this, meta: this.meta }));\n    socket.on('error', (err) => this.emit('error', { source: this, error: err }));\n    this.emit('open', { source: this, meta: this.meta });\n  }\n\n  private onRx(data: Buffer): void {\n    const e: TrafficEvent = { ts: Date.now(), dir: 'rx', data, transport: this.meta };\n    this.emitData(e);\n  }\n\n  async send(data: Buffer): Promise<void> {\n    const socket = this.socket;\n    if (!socket) throw new Error('tcp-client: not connected');\n    await new Promise<void>((resolve, reject) => {\n      socket.write(data, (err) => (err ? reject(err) : resolve()));\n    });\n    const e: TrafficEvent = { ts: Date.now(), dir: 'tx', data, transport: this.meta };\n    this.emitData(e);\n  }\n\n  async stop(): Promise<void> {\n    this.socket?.destroy();\n    this.socket = undefined;\n  }\n}\n\n/** Inbound TCP server: listens and monitors every accepted client. */\nexport class TcpServerTransport extends TrafficBus implements Transport {\n  private server: net.Server | undefined;\n  private readonly sockets = new Map<string, net.Socket>();\n\n  constructor(\n    private readonly host: string,\n    private readonly port: number,\n  ) {\n    super();\n  }\n\n  async start(): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      const server = net.createServer((socket) => this.onConnection(socket));\n      server.once('error', reject);\n      server.listen(this.port, this.host || undefined, () => {\n        server.off('error', reject);\n        resolve();\n      });\n      this.server = server;\n    });\n    const meta: TransportMeta = {\n      kind: 'tcp-server',\n      id: `${this.host || '0.0.0.0'}:${this.port}`,\n      desc: `tcp-listen:${this.host ? `${this.host}:` : ''}${this.port}`,\n    };\n    this.emit('open', { source: this, meta });\n  }\n\n  private onConnection(socket: net.Socket): void {\n    const remote = `${socket.remoteAddress ?? '?'}:${socket.remotePort ?? '?'}`;\n    const meta: TransportMeta = {\n      kind: 'tcp-server',\n      id: remote,\n      desc: `tcp-listen:${this.port}#${remote}`,\n    };\n    this.sockets.set(remote, socket);\n    socket.on('data', (data: Buffer) => {\n      const e: TrafficEvent = { ts: Date.now(), dir: 'rx', data, transport: meta };\n      this.emitData(e);\n    });\n    socket.on('close', () => this.sockets.delete(remote));\n    socket.on('error', (err) => this.emit('error', { source: this, error: err }));\n  }\n\n  async send(data: Buffer): Promise<void> {\n    const writes: Promise<void>[] = [];\n    for (const socket of this.sockets.values()) {\n      writes.push(\n        new Promise<void>((resolve, reject) => {\n          socket.write(data, (err) => (err ? reject(err) : resolve()));\n        }),\n      );\n    }\n    await Promise.all(writes);\n  }\n\n  async stop(): Promise<void> {\n    for (const socket of this.sockets.values()) socket.destroy();\n    this.sockets.clear();\n    await new Promise<void>((resolve) => {\n      if (!this.server) return resolve();\n      this.server.close(() => resolve());\n    });\n    this.server = undefined;\n  }\n}\n","import dgram from 'node:dgram';\nimport type { TrafficEvent, TransportMeta } from '../event/events.js';\nimport { TrafficBus } from '../event/bus.js';\nimport type { Transport } from './transport.js';\n\ntype UdpType = 'udp4' | 'udp6';\n\nfunction udpTypeFor(host: string): UdpType {\n  return host.includes(':') ? 'udp6' : 'udp4';\n}\n\n/** Point-to-point UDP: sends to `host:port`, receives replies from it only. */\nexport class UdpTransport extends TrafficBus implements Transport {\n  private socket: dgram.Socket | undefined;\n  private readonly meta: TransportMeta;\n\n  constructor(\n    private readonly host: string,\n    private readonly port: number,\n  ) {\n    super();\n    this.meta = { kind: 'udp', id: `${host}:${port}`, desc: `udp:${host}:${port}` };\n  }\n\n  async start(): Promise<void> {\n    const socket = dgram.createSocket(udpTypeFor(this.host));\n    this.socket = socket;\n    await new Promise<void>((resolve, reject) => {\n      socket.once('error', reject);\n      socket.bind(0, () => {\n        socket.off('error', reject);\n        resolve();\n      });\n    });\n    socket.on('message', (msg: Buffer, rinfo) => {\n      // Only accept datagrams from the configured peer.\n      if (rinfo.address !== this.host || rinfo.port !== this.port) return;\n      const e: TrafficEvent = { ts: Date.now(), dir: 'rx', data: msg, transport: this.meta };\n      this.emitData(e);\n    });\n    socket.on('error', (err) => this.emit('error', { source: this, error: err }));\n    this.emit('open', { source: this, meta: this.meta });\n  }\n\n  async send(data: Buffer): Promise<void> {\n    const socket = this.socket;\n    if (!socket) throw new Error('udp: not bound');\n    await new Promise<void>((resolve, reject) => {\n      socket.send(data, this.port, this.host, (err) => (err ? reject(err) : resolve()));\n    });\n    const e: TrafficEvent = { ts: Date.now(), dir: 'tx', data, transport: this.meta };\n    this.emitData(e);\n  }\n\n  async stop(): Promise<void> {\n    await new Promise<void>((resolve) => {\n      if (!this.socket) return resolve();\n      this.socket.close(() => resolve());\n    });\n    this.socket = undefined;\n  }\n}\n\n/** Passive UDP listener: binds a local port and monitors datagrams from anyone. */\nexport class UdpListenTransport extends TrafficBus implements Transport {\n  private socket: dgram.Socket | undefined;\n  private lastPeer: { address: string; port: number } | undefined;\n  private readonly meta: TransportMeta;\n\n  constructor(\n    private readonly host: string,\n    private readonly port: number,\n  ) {\n    super();\n    const label = `${this.host || '0.0.0.0'}:${this.port}`;\n    this.meta = { kind: 'udp-listen', id: label, desc: `udp-listen:${label}` };\n  }\n\n  async start(): Promise<void> {\n    const socket = dgram.createSocket(udpTypeFor(this.host));\n    this.socket = socket;\n    await new Promise<void>((resolve, reject) => {\n      socket.once('error', reject);\n      socket.bind(this.port, this.host || undefined, () => {\n        socket.off('error', reject);\n        resolve();\n      });\n    });\n    socket.on('message', (msg: Buffer, rinfo) => {\n      this.lastPeer = { address: rinfo.address, port: rinfo.port };\n      const meta: TransportMeta = {\n        kind: 'udp-listen',\n        id: `${rinfo.address}:${rinfo.port}`,\n        desc: this.meta.desc,\n      };\n      const e: TrafficEvent = { ts: Date.now(), dir: 'rx', data: msg, transport: meta };\n      this.emitData(e);\n    });\n    socket.on('error', (err) => this.emit('error', { source: this, error: err }));\n    this.emit('open', { source: this, meta: this.meta });\n  }\n\n  async send(data: Buffer): Promise<void> {\n    const socket = this.socket;\n    const peer = this.lastPeer;\n    if (!socket) throw new Error('udp-listen: not bound');\n    if (!peer) throw new Error('udp-listen: no peer has sent yet');\n    await new Promise<void>((resolve, reject) => {\n      socket.send(data, peer.port, peer.address, (err) => (err ? reject(err) : resolve()));\n    });\n  }\n\n  async stop(): Promise<void> {\n    await new Promise<void>((resolve) => {\n      if (!this.socket) return resolve();\n      this.socket.close(() => resolve());\n    });\n    this.socket = undefined;\n  }\n}\n","import { SerialPort } from 'serialport';\nimport type { TrafficEvent, TransportMeta } from '../event/events.js';\nimport { TrafficBus } from '../event/bus.js';\nimport type { Transport } from './transport.js';\n\nexport const DEFAULT_BAUD = 115200;\n\n/** Serial transport backed by the `serialport` native binding. */\nexport class SerialTransport extends TrafficBus implements Transport {\n  private port: SerialPort | undefined;\n  private readonly meta: TransportMeta;\n\n  constructor(\n    private readonly path: string,\n    private readonly baud: number,\n  ) {\n    super();\n    this.meta = { kind: 'serial', id: path, desc: `serial:${path}:${baud}` };\n  }\n\n  async start(): Promise<void> {\n    const port = new SerialPort({ path: this.path, baudRate: this.baud });\n    this.port = port;\n    await new Promise<void>((resolve, reject) => {\n      port.once('open', resolve);\n      port.once('error', reject);\n    });\n    port.on('data', (data: Buffer) => {\n      const e: TrafficEvent = { ts: Date.now(), dir: 'rx', data, transport: this.meta };\n      this.emitData(e);\n    });\n    port.on('close', () => this.emit('close', { source: this, meta: this.meta }));\n    port.on('error', (err) => this.emit('error', { source: this, error: err }));\n    this.emit('open', { source: this, meta: this.meta });\n  }\n\n  async send(data: Buffer): Promise<void> {\n    if (!this.port) throw new Error('serial: not open');\n    await new Promise<void>((resolve, reject) => {\n      this.port!.write(data, (err) => (err ? reject(err) : resolve()));\n    });\n    const e: TrafficEvent = { ts: Date.now(), dir: 'tx', data, transport: this.meta };\n    this.emitData(e);\n  }\n\n  async stop(): Promise<void> {\n    if (!this.port) return;\n    const port = this.port;\n    this.port = undefined;\n    await new Promise<void>((resolve) => port.close(() => resolve()));\n  }\n}\n\n/** Enumerate attached serial ports. */\nexport async function listSerialPorts(): Promise<{ path: string; manufacturer?: string }[]> {\n  const ports = await SerialPort.list();\n  return ports.map((p) => ({ path: p.path, manufacturer: p.manufacturer }));\n}\n","import type { Transport } from './transport.js';\nimport { TcpClientTransport, TcpServerTransport } from './tcp.js';\nimport { UdpTransport, UdpListenTransport } from './udp.js';\nimport { SerialTransport, DEFAULT_BAUD } from './serial.js';\n\n/**\n * Parsed form of a transport spec string such as `tcp-listen:9000`.\n * Reversible: {@link toDesc} regenerates the canonical spec.\n */\nexport type TransportSpec =\n  | { kind: 'serial'; port: string; baud: number }\n  | { kind: 'tcp-client'; host: string; port: number }\n  | { kind: 'tcp-server'; host: string; port: number }\n  | { kind: 'udp'; host: string; port: number }\n  | { kind: 'udp-listen'; host: string; port: number };\n\nfunction parsePort(s: string): number {\n  if (!/^\\d+$/.test(s)) throw new Error(`invalid port \"${s}\"`);\n  const p = Number(s);\n  if (p < 1 || p > 65535) throw new Error(`port out of range \"${s}\"`);\n  return p;\n}\n\nfunction parseBaud(s: string): number {\n  if (!/^\\d+$/.test(s)) throw new Error(`invalid baud \"${s}\"`);\n  const b = Number(s);\n  if (b < 1) throw new Error(`invalid baud \"${s}\"`);\n  return b;\n}\n\n/** Split `host:port`, accepting bracketed IPv6 `[::1]:9000`. */\nfunction splitHostPort(s: string): { host: string; port: number } {\n  let host: string;\n  let portStr: string;\n  if (s.startsWith('[')) {\n    const close = s.indexOf(']');\n    if (close < 0) throw new Error(`invalid host:port \"${s}\"`);\n    host = s.slice(1, close);\n    portStr = s.slice(close + 1);\n    if (!portStr.startsWith(':')) throw new Error(`invalid host:port \"${s}\"`);\n    portStr = portStr.slice(1);\n  } else {\n    const i = s.lastIndexOf(':');\n    if (i < 0) throw new Error(`missing port in \"${s}\"`);\n    host = s.slice(0, i);\n    portStr = s.slice(i + 1);\n  }\n  return { host, port: parsePort(portStr) };\n}\n\n/** Split `port` or `host:port` for listener schemes (bind address optional). */\nfunction splitListen(s: string): { host: string; port: number } {\n  if (!s.includes(':')) return { host: '', port: parsePort(s) };\n  return splitHostPort(s);\n}\n\n/** Split `path` or `path:baud` for serial. */\nfunction splitSerial(s: string): { path: string; baud: number } {\n  const parts = s.split(':');\n  if (parts.length >= 2 && /^\\d+$/.test(parts[1]!)) {\n    return { path: parts[0]!, baud: parseBaud(parts[1]!) };\n  }\n  return { path: s, baud: DEFAULT_BAUD };\n}\n\n/** Parse a transport spec string into its structured form. */\nexport function parseSpec(spec: string): TransportSpec {\n  const idx = spec.indexOf(':');\n  if (idx < 0) throw new Error(`invalid transport spec \"${spec}\" (expected \"scheme:...\")`);\n  const scheme = spec.slice(0, idx);\n  const rest = spec.slice(idx + 1);\n\n  switch (scheme) {\n    case 'serial': {\n      const { path, baud } = splitSerial(rest);\n      return { kind: 'serial', port: path, baud };\n    }\n    case 'tcp': {\n      const { host, port } = splitHostPort(rest);\n      return { kind: 'tcp-client', host, port };\n    }\n    case 'tcp-listen': {\n      const { host, port } = splitListen(rest);\n      return { kind: 'tcp-server', host, port };\n    }\n    case 'udp': {\n      const { host, port } = splitHostPort(rest);\n      return { kind: 'udp', host, port };\n    }\n    case 'udp-listen': {\n      const { host, port } = splitListen(rest);\n      return { kind: 'udp-listen', host, port };\n    }\n    default:\n      throw new Error(`unknown transport scheme \"${scheme}\"`);\n  }\n}\n\n/** Canonical, reversible descriptor for a spec. */\nexport function toDesc(spec: TransportSpec): string {\n  switch (spec.kind) {\n    case 'serial':\n      return `serial:${spec.port}:${spec.baud}`;\n    case 'tcp-client':\n      return `tcp:${spec.host}:${spec.port}`;\n    case 'tcp-server':\n      return `tcp-listen:${spec.host ? `${spec.host}:` : ''}${spec.port}`;\n    case 'udp':\n      return `udp:${spec.host}:${spec.port}`;\n    case 'udp-listen':\n      return `udp-listen:${spec.host ? `${spec.host}:` : ''}${spec.port}`;\n  }\n}\n\n/** Construct the concrete {@link Transport} for a parsed spec. */\nexport function createTransport(spec: TransportSpec): Transport {\n  switch (spec.kind) {\n    case 'serial':\n      return new SerialTransport(spec.port, spec.baud);\n    case 'tcp-client':\n      return new TcpClientTransport(spec.host, spec.port);\n    case 'tcp-server':\n      return new TcpServerTransport(spec.host, spec.port);\n    case 'udp':\n      return new UdpTransport(spec.host, spec.port);\n    case 'udp-listen':\n      return new UdpListenTransport(spec.host, spec.port);\n  }\n}\n","import type { Direction, TrafficEvent } from '../event/events.js';\n\n/** Parse a hex string (spaces and `0x` tolerated) into a Buffer. */\nexport function hexToBuffer(s: string): Buffer {\n  const clean = s.replace(/0x/gi, '').replace(/[\\s,]/g, '');\n  if (clean.length % 2 !== 0) throw new Error(`hex string has odd length: \"${s}\"`);\n  if (!/^[0-9a-f]*$/i.test(clean)) throw new Error(`invalid hex string: \"${s}\"`);\n  const buf = Buffer.alloc(clean.length / 2);\n  for (let i = 0; i < buf.length; i++) buf[i] = parseInt(clean.slice(i * 2, i * 2 + 2), 16);\n  return buf;\n}\n\nexport interface FilterOptions {\n  /** Only pass events in this direction. */\n  dir?: Direction;\n  /** Byte-sequence match against the raw payload. */\n  hex?: Buffer;\n  /** Literal (UTF-8) substring match against the raw payload. */\n  string?: Buffer;\n  /** Regex matched against the UTF-8-decoded payload. */\n  regex?: RegExp;\n}\n\n/**\n * Per-event predicate. All specified criteria must pass for an event to be\n * forwarded to sinks. Note this matches within a single event; stream-level\n * patterns that span event boundaries belong to the search/analysis layer.\n */\nexport class Matcher {\n  constructor(private readonly opts: FilterOptions) {}\n\n  matches(e: TrafficEvent): boolean {\n    if (this.opts.dir && e.dir !== this.opts.dir) return false;\n    if (this.opts.hex && !e.data.includes(this.opts.hex)) return false;\n    if (this.opts.string && !e.data.includes(this.opts.string)) return false;\n    if (this.opts.regex && !this.opts.regex.test(e.data.toString('utf8'))) return false;\n    return true;\n  }\n}\n","import type { DataSource } from './source/source.js';\nimport type { Sink } from './sink/sink.js';\nimport type { Matcher } from './sink/filter.js';\nimport type { TrafficEvent } from './event/events.js';\n\nexport interface SessionOptions {\n  filter?: Matcher;\n  sinks?: Sink[];\n}\n\n/**\n * Wires a {@link DataSource} to a set of sinks, applying an optional filter.\n * This is the shared glue behind `monitor`, `view` and `replay`: the source is\n * swapped (live transport vs recording file), the sink graph stays the same.\n */\nexport class Session {\n  private readonly sinks: Sink[];\n  private finished = false;\n\n  constructor(\n    private readonly source: DataSource,\n    private readonly opts: SessionOptions = {},\n  ) {\n    this.sinks = opts.sinks ?? [];\n  }\n\n  async run(): Promise<void> {\n    this.source.on('data', (e) => this.dispatch(e));\n    this.source.on('close', () => this.finish());\n    await this.source.start();\n  }\n\n  private dispatch(e: TrafficEvent): void {\n    if (this.opts.filter && !this.opts.filter.matches(e)) return;\n    for (const sink of this.sinks) sink.onEvent(e);\n  }\n\n  private finish(): void {\n    if (this.finished) return;\n    this.finished = true;\n    for (const sink of this.sinks) sink.onClose();\n  }\n\n  async stop(): Promise<void> {\n    await this.source.stop();\n    this.finish();\n  }\n}\n","import type { Direction, TrafficEvent, TransportKind } from '../event/events.js';\n\n/**\n * JSON Lines recording format.\n *\n * First line is a header carrying a magic key (`comm-scope`) plus the schema\n * version and session metadata. Every following line is a single traffic\n * event, payload encoded as lowercase hex so binary data round-trips cleanly\n * through JSON without escaping concerns.\n */\n\nexport const SCHEMA_VERSION = 1;\nexport const MAGIC_KEY = 'comm-scope';\n\nexport interface SessionHeader {\n  version: number;\n  kind: TransportKind;\n  id: string;\n  desc: string;\n  started: number;\n}\n\nexport function encodeHeader(h: SessionHeader): string {\n  return JSON.stringify({\n    [MAGIC_KEY]: h.version,\n    kind: h.kind,\n    id: h.id,\n    desc: h.desc,\n    started: h.started,\n  });\n}\n\nexport function decodeHeader(line: string): SessionHeader {\n  const o = JSON.parse(line) as Record<string, unknown>;\n  const version = o[MAGIC_KEY];\n  if (typeof version !== 'number') {\n    throw new Error('not a comm-scope recording (missing header)');\n  }\n  if (version !== SCHEMA_VERSION) {\n    throw new Error(`unsupported recording schema version ${version}`);\n  }\n  return {\n    version,\n    kind: o.kind as TransportKind,\n    id: String(o.id ?? ''),\n    desc: String(o.desc ?? ''),\n    started: Number(o.started ?? 0),\n  };\n}\n\nexport function encodeEvent(e: TrafficEvent): string {\n  return JSON.stringify({\n    t: e.ts,\n    dir: e.dir,\n    kind: e.transport.kind,\n    id: e.transport.id,\n    desc: e.transport.desc,\n    enc: 'hex',\n    data: e.data.toString('hex'),\n  });\n}\n\nexport function decodeEvent(line: string): TrafficEvent {\n  const o = JSON.parse(line) as Record<string, unknown>;\n  if (o.enc !== 'hex') throw new Error(`unsupported payload encoding \"${String(o.enc)}\"`);\n  const dir = o.dir as Direction;\n  if (dir !== 'rx' && dir !== 'tx') throw new Error(`invalid direction \"${String(o.dir)}\"`);\n  return {\n    ts: Number(o.t),\n    dir,\n    data: Buffer.from(String(o.data), 'hex'),\n    transport: {\n      kind: o.kind as TransportKind,\n      id: String(o.id ?? ''),\n      desc: String(o.desc ?? ''),\n    },\n  };\n}\n","import type { Writable } from 'node:stream';\nimport type { TrafficEvent } from '../event/events.js';\nimport type { Sink } from './sink.js';\nimport { encodeEvent, encodeHeader } from '../format/jsonl.js';\nimport type { SessionHeader } from '../format/jsonl.js';\n\n/**\n * Writes traffic as JSON Lines. Owns the target stream: it writes the header\n * immediately and ends the stream when the session closes.\n */\nexport class JsonlRecorder implements Sink {\n  private readonly header: SessionHeader;\n\n  constructor(\n    private readonly stream: Writable,\n    header: SessionHeader,\n  ) {\n    this.header = header;\n    this.stream.write(encodeHeader(header) + '\\n');\n  }\n\n  onEvent(e: TrafficEvent): void {\n    this.stream.write(encodeEvent(e) + '\\n');\n  }\n\n  onClose(): void {\n    this.stream.end();\n  }\n}\n","import fs from 'node:fs';\nimport readline from 'node:readline';\nimport type { Direction, TransportMeta } from '../event/events.js';\nimport { TrafficBus } from '../event/bus.js';\nimport type { DataSource } from './source.js';\nimport { decodeEvent, decodeHeader } from '../format/jsonl.js';\nimport type { SessionHeader } from '../format/jsonl.js';\n\nconst sleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\nexport interface FileSourceOptions {\n  /** Replay speed multiplier. 1 = real-time, 0 = as fast as possible. */\n  speed?: number;\n  /** Optional direction filter applied while reading. */\n  dir?: Direction;\n}\n\n/**\n * Offline data source: reads a recording and re-emits its events at the\n * original timing (scaled by `speed`). Swappable for any live transport, which\n * is what makes `view` behave identically to `monitor`.\n */\nexport class FileSource extends TrafficBus implements DataSource {\n  private stopped = false;\n  private rl: readline.Interface | undefined;\n  private readonly meta: TransportMeta;\n\n  constructor(\n    private readonly file: string,\n    private readonly opts: FileSourceOptions = {},\n  ) {\n    super();\n    // Placeholder meta; replaced by the header's metadata once read.\n    this.meta = { kind: 'serial', id: file, desc: file };\n  }\n\n  async start(): Promise<void> {\n    this.stopped = false;\n    const rl = readline.createInterface({\n      input: fs.createReadStream(this.file),\n      crlfDelay: Infinity,\n    });\n    this.rl = rl;\n\n    const speed = this.opts.speed ?? 1;\n    let prevT: number | undefined;\n    let header: SessionHeader | undefined;\n\n    try {\n      for await (const line of rl) {\n        if (this.stopped) break;\n        if (header === undefined) {\n          header = decodeHeader(line);\n          this.emit('open', { source: this, meta: this.headerMeta(header) });\n          continue;\n        }\n        const e = decodeEvent(line);\n        if (this.opts.dir && e.dir !== this.opts.dir) continue;\n        if (prevT !== undefined && speed > 0) {\n          const wait = (e.ts - prevT) / speed;\n          if (wait > 0) await sleep(wait);\n        }\n        prevT = e.ts;\n        this.emitData(e);\n      }\n    } finally {\n      if (!this.stopped) {\n        this.emit('close', { source: this, meta: this.meta });\n      }\n    }\n  }\n\n  private headerMeta(h: SessionHeader): TransportMeta {\n    return { kind: h.kind, id: h.id, desc: h.desc };\n  }\n\n  async stop(): Promise<void> {\n    this.stopped = true;\n    this.rl?.close();\n  }\n}\n","import type { TrafficEvent } from '../event/events.js';\nimport type { Sink } from './sink.js';\n\nexport interface TrafficStats {\n  firstTs: number;\n  lastTs: number;\n  rxBytes: number;\n  txBytes: number;\n  rxPackets: number;\n  txPackets: number;\n}\n\nexport interface TrafficSummary extends TrafficStats {\n  durationMs: number;\n  rxRate: number;\n  txRate: number;\n  totalRate: number;\n}\n\n/**\n * Accumulates byte/packet counters and rates. Attach alongside a renderer or\n * recorder; call {@link summarize} when the session ends.\n */\nexport class Analyzer implements Sink {\n  private firstTs = 0;\n  private lastTs = 0;\n  private rxBytes = 0;\n  private txBytes = 0;\n  private rxPackets = 0;\n  private txPackets = 0;\n\n  onEvent(e: TrafficEvent): void {\n    if (this.firstTs === 0) this.firstTs = e.ts;\n    this.lastTs = e.ts;\n    if (e.dir === 'rx') {\n      this.rxBytes += e.data.length;\n      this.rxPackets++;\n    } else {\n      this.txBytes += e.data.length;\n      this.txPackets++;\n    }\n  }\n\n  onClose(): void {}\n\n  summarize(): TrafficSummary {\n    const durationMs = Math.max(0, this.lastTs - this.firstTs);\n    const secs = durationMs / 1000 || 1;\n    return {\n      firstTs: this.firstTs,\n      lastTs: this.lastTs,\n      rxBytes: this.rxBytes,\n      txBytes: this.txBytes,\n      rxPackets: this.rxPackets,\n      txPackets: this.txPackets,\n      durationMs,\n      rxRate: this.rxBytes / secs,\n      txRate: this.txBytes / secs,\n      totalRate: (this.rxBytes + this.txBytes) / secs,\n    };\n  }\n}\n","import fs from 'node:fs';\nimport readline from 'node:readline';\nimport type { Direction, TrafficEvent } from '../event/events.js';\nimport type { Transport } from '../transport/transport.js';\nimport { decodeHeader, decodeEvent } from '../format/jsonl.js';\n\nconst sleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\n/** Read a recording's events into memory, optionally filtering by direction. */\nexport async function readEvents(file: string, dir?: Direction): Promise<TrafficEvent[]> {\n  const events: TrafficEvent[] = [];\n  const rl = readline.createInterface({\n    input: fs.createReadStream(file),\n    crlfDelay: Infinity,\n  });\n  let headerSeen = false;\n  for await (const line of rl) {\n    if (!headerSeen) {\n      decodeHeader(line);\n      headerSeen = true;\n      continue;\n    }\n    const e = decodeEvent(line);\n    if (dir && e.dir !== dir) continue;\n    events.push(e);\n  }\n  return events;\n}\n\nexport interface ReplayOptions {\n  /** Replay speed multiplier. 1 = real-time, 0 = as fast as possible. */\n  speed?: number;\n  /** Only replay events in this direction. Defaults to all. */\n  dir?: Direction;\n  /** Re-send continuously until interrupted. */\n  loop?: boolean;\n  /** Progress callback, fired once per event sent. */\n  onProgress?: (sent: number, total: number) => void;\n}\n\n/**\n * Re-send a recording's bytes to a live transport at the original timing.\n * Resolves once finished (never, when `loop` is set — interrupt externally).\n */\nexport async function replayFileToTransport(\n  file: string,\n  target: Transport,\n  opts: ReplayOptions = {},\n): Promise<number> {\n  const events = await readEvents(file, opts.dir);\n  const speed = opts.speed ?? 1;\n  const total = events.length;\n  let sent = 0;\n\n  for (;;) {\n    let prevT: number | undefined;\n    for (const e of events) {\n      if (prevT !== undefined && speed > 0) {\n        const wait = (e.ts - prevT) / speed;\n        if (wait > 0) await sleep(wait);\n      }\n      prevT = e.ts;\n      await target.send(e.data);\n      sent++;\n      opts.onProgress?.(sent, total);\n    }\n    if (!opts.loop) break;\n  }\n\n  return sent;\n}\n"],"mappings":";AAAA,SAAS,oBAAoB;AAQtB,IAAM,aAAN,MAAiB;AAAA,EACL,UAAU,IAAI,aAAa;AAAA,EAI5C,GAAG,OAAe,IAAoC;AACpD,SAAK,QAAQ,GAAG,OAAO,EAAE;AAAA,EAC3B;AAAA,EAEA,IAAI,OAAe,IAAoC;AACrD,SAAK,QAAQ,IAAI,OAAO,EAAE;AAAA,EAC5B;AAAA,EAEU,SAAS,GAAuB;AACxC,SAAK,QAAQ,KAAK,QAAQ,CAAC;AAAA,EAC7B;AAAA,EAEU,KACR,OACA,SACM;AACN,SAAK,QAAQ,KAAK,OAAO,OAAO;AAAA,EAClC;AACF;;;AC1BA,IAAM,MAAM;AAEZ,SAAS,QAAQ,GAAmB;AAClC,SAAO,IAAK,KAAK,IAAK,EAAG,IAAK,IAAI,IAAI,EAAG;AAC3C;AAGO,SAAS,MAAM,KAAqB;AACzC,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,QAAI,IAAI,EAAG,QAAO;AAClB,WAAO,QAAQ,IAAI,CAAC,CAAE;AAAA,EACxB;AACA,SAAO;AACT;AAGO,SAAS,QAAQ,KAAqB;AAC3C,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,UAAM,IAAI,IAAI,CAAC;AACf,WAAO,KAAK,MAAQ,KAAK,MAAO,OAAO,aAAa,CAAC,IAAI;AAAA,EAC3D;AACA,SAAO;AACT;AAaO,SAAS,QAAQ,KAAa,cAAc,IAAmB;AACpE,QAAM,QAAuB,CAAC;AAC9B,WAAS,OAAO,GAAG,OAAO,IAAI,QAAQ,QAAQ,aAAa;AACzD,UAAM,MAAM,IAAI,SAAS,MAAM,OAAO,WAAW;AACjD,UAAM,WAAqB,CAAC;AAC5B,QAAI,QAAQ;AACZ,aAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,eAAS,KAAK,QAAQ,IAAI,CAAC,CAAE,CAAC;AAC9B,UAAI,MAAM,EAAG,UAAS,KAAK,GAAG;AAC9B,eAAS,QAAQ,IAAI,SAAS,GAAG,IAAI,CAAC,CAAC;AAAA,IACzC;AAEA,UAAM,YAAY,cAAc,IAAI,KAAK,MAAM,cAAc,CAAC;AAC9D,UAAM,MAAM,SAAS,KAAK,GAAG,EAAE,OAAO,WAAW,GAAG;AACpD,UAAM,KAAK;AAAA,MACT,QAAQ,KAAK,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAAA,MACzC;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AACT;;;AC/DA,OAAO,SAAS;AAMT,IAAM,qBAAN,cAAiC,WAAgC;AAAA,EAItE,YACmB,MACA,MACjB;AACA,UAAM;AAHW;AACA;AAGjB,SAAK,OAAO;AAAA,MACV,MAAM;AAAA,MACN,IAAI,GAAG,IAAI,IAAI,IAAI;AAAA,MACnB,MAAM,OAAO,IAAI,IAAI,IAAI;AAAA,IAC3B;AAAA,EACF;AAAA,EATmB;AAAA,EACA;AAAA,EALX;AAAA,EACS;AAAA,EAcjB,MAAM,QAAuB;AAC3B,UAAM,SAAS,IAAI,iBAAiB,EAAE,MAAM,KAAK,MAAM,MAAM,KAAK,KAAK,CAAC;AACxE,SAAK,SAAS;AACd,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,aAAO,KAAK,WAAW,OAAO;AAC9B,aAAO,KAAK,SAAS,MAAM;AAAA,IAC7B,CAAC;AACD,WAAO,GAAG,QAAQ,CAAC,SAAiB,KAAK,KAAK,IAAI,CAAC;AACnD,WAAO,GAAG,SAAS,MAAM,KAAK,KAAK,SAAS,EAAE,QAAQ,MAAM,MAAM,KAAK,KAAK,CAAC,CAAC;AAC9E,WAAO,GAAG,SAAS,CAAC,QAAQ,KAAK,KAAK,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC,CAAC;AAC5E,SAAK,KAAK,QAAQ,EAAE,QAAQ,MAAM,MAAM,KAAK,KAAK,CAAC;AAAA,EACrD;AAAA,EAEQ,KAAK,MAAoB;AAC/B,UAAM,IAAkB,EAAE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,WAAW,KAAK,KAAK;AAChF,SAAK,SAAS,CAAC;AAAA,EACjB;AAAA,EAEA,MAAM,KAAK,MAA6B;AACtC,UAAM,SAAS,KAAK;AACpB,QAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,2BAA2B;AACxD,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,aAAO,MAAM,MAAM,CAAC,QAAS,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAE;AAAA,IAC7D,CAAC;AACD,UAAM,IAAkB,EAAE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,WAAW,KAAK,KAAK;AAChF,SAAK,SAAS,CAAC;AAAA,EACjB;AAAA,EAEA,MAAM,OAAsB;AAC1B,SAAK,QAAQ,QAAQ;AACrB,SAAK,SAAS;AAAA,EAChB;AACF;AAGO,IAAM,qBAAN,cAAiC,WAAgC;AAAA,EAItE,YACmB,MACA,MACjB;AACA,UAAM;AAHW;AACA;AAAA,EAGnB;AAAA,EAJmB;AAAA,EACA;AAAA,EALX;AAAA,EACS,UAAU,oBAAI,IAAwB;AAAA,EASvD,MAAM,QAAuB;AAC3B,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,YAAM,SAAS,IAAI,aAAa,CAAC,WAAW,KAAK,aAAa,MAAM,CAAC;AACrE,aAAO,KAAK,SAAS,MAAM;AAC3B,aAAO,OAAO,KAAK,MAAM,KAAK,QAAQ,QAAW,MAAM;AACrD,eAAO,IAAI,SAAS,MAAM;AAC1B,gBAAQ;AAAA,MACV,CAAC;AACD,WAAK,SAAS;AAAA,IAChB,CAAC;AACD,UAAM,OAAsB;AAAA,MAC1B,MAAM;AAAA,MACN,IAAI,GAAG,KAAK,QAAQ,SAAS,IAAI,KAAK,IAAI;AAAA,MAC1C,MAAM,cAAc,KAAK,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,GAAG,KAAK,IAAI;AAAA,IAClE;AACA,SAAK,KAAK,QAAQ,EAAE,QAAQ,MAAM,KAAK,CAAC;AAAA,EAC1C;AAAA,EAEQ,aAAa,QAA0B;AAC7C,UAAM,SAAS,GAAG,OAAO,iBAAiB,GAAG,IAAI,OAAO,cAAc,GAAG;AACzE,UAAM,OAAsB;AAAA,MAC1B,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,MAAM,cAAc,KAAK,IAAI,IAAI,MAAM;AAAA,IACzC;AACA,SAAK,QAAQ,IAAI,QAAQ,MAAM;AAC/B,WAAO,GAAG,QAAQ,CAAC,SAAiB;AAClC,YAAM,IAAkB,EAAE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,WAAW,KAAK;AAC3E,WAAK,SAAS,CAAC;AAAA,IACjB,CAAC;AACD,WAAO,GAAG,SAAS,MAAM,KAAK,QAAQ,OAAO,MAAM,CAAC;AACpD,WAAO,GAAG,SAAS,CAAC,QAAQ,KAAK,KAAK,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC,CAAC;AAAA,EAC9E;AAAA,EAEA,MAAM,KAAK,MAA6B;AACtC,UAAM,SAA0B,CAAC;AACjC,eAAW,UAAU,KAAK,QAAQ,OAAO,GAAG;AAC1C,aAAO;AAAA,QACL,IAAI,QAAc,CAAC,SAAS,WAAW;AACrC,iBAAO,MAAM,MAAM,CAAC,QAAS,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAE;AAAA,QAC7D,CAAC;AAAA,MACH;AAAA,IACF;AACA,UAAM,QAAQ,IAAI,MAAM;AAAA,EAC1B;AAAA,EAEA,MAAM,OAAsB;AAC1B,eAAW,UAAU,KAAK,QAAQ,OAAO,EAAG,QAAO,QAAQ;AAC3D,SAAK,QAAQ,MAAM;AACnB,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,UAAI,CAAC,KAAK,OAAQ,QAAO,QAAQ;AACjC,WAAK,OAAO,MAAM,MAAM,QAAQ,CAAC;AAAA,IACnC,CAAC;AACD,SAAK,SAAS;AAAA,EAChB;AACF;;;AC3HA,OAAO,WAAW;AAOlB,SAAS,WAAW,MAAuB;AACzC,SAAO,KAAK,SAAS,GAAG,IAAI,SAAS;AACvC;AAGO,IAAM,eAAN,cAA2B,WAAgC;AAAA,EAIhE,YACmB,MACA,MACjB;AACA,UAAM;AAHW;AACA;AAGjB,SAAK,OAAO,EAAE,MAAM,OAAO,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,MAAM,OAAO,IAAI,IAAI,IAAI,GAAG;AAAA,EAChF;AAAA,EALmB;AAAA,EACA;AAAA,EALX;AAAA,EACS;AAAA,EAUjB,MAAM,QAAuB;AAC3B,UAAM,SAAS,MAAM,aAAa,WAAW,KAAK,IAAI,CAAC;AACvD,SAAK,SAAS;AACd,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,aAAO,KAAK,SAAS,MAAM;AAC3B,aAAO,KAAK,GAAG,MAAM;AACnB,eAAO,IAAI,SAAS,MAAM;AAC1B,gBAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AACD,WAAO,GAAG,WAAW,CAAC,KAAa,UAAU;AAE3C,UAAI,MAAM,YAAY,KAAK,QAAQ,MAAM,SAAS,KAAK,KAAM;AAC7D,YAAM,IAAkB,EAAE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,KAAK,WAAW,KAAK,KAAK;AACrF,WAAK,SAAS,CAAC;AAAA,IACjB,CAAC;AACD,WAAO,GAAG,SAAS,CAAC,QAAQ,KAAK,KAAK,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC,CAAC;AAC5E,SAAK,KAAK,QAAQ,EAAE,QAAQ,MAAM,MAAM,KAAK,KAAK,CAAC;AAAA,EACrD;AAAA,EAEA,MAAM,KAAK,MAA6B;AACtC,UAAM,SAAS,KAAK;AACpB,QAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,gBAAgB;AAC7C,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,aAAO,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,CAAC,QAAS,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAE;AAAA,IAClF,CAAC;AACD,UAAM,IAAkB,EAAE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,WAAW,KAAK,KAAK;AAChF,SAAK,SAAS,CAAC;AAAA,EACjB;AAAA,EAEA,MAAM,OAAsB;AAC1B,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,UAAI,CAAC,KAAK,OAAQ,QAAO,QAAQ;AACjC,WAAK,OAAO,MAAM,MAAM,QAAQ,CAAC;AAAA,IACnC,CAAC;AACD,SAAK,SAAS;AAAA,EAChB;AACF;AAGO,IAAM,qBAAN,cAAiC,WAAgC;AAAA,EAKtE,YACmB,MACA,MACjB;AACA,UAAM;AAHW;AACA;AAGjB,UAAM,QAAQ,GAAG,KAAK,QAAQ,SAAS,IAAI,KAAK,IAAI;AACpD,SAAK,OAAO,EAAE,MAAM,cAAc,IAAI,OAAO,MAAM,cAAc,KAAK,GAAG;AAAA,EAC3E;AAAA,EANmB;AAAA,EACA;AAAA,EANX;AAAA,EACA;AAAA,EACS;AAAA,EAWjB,MAAM,QAAuB;AAC3B,UAAM,SAAS,MAAM,aAAa,WAAW,KAAK,IAAI,CAAC;AACvD,SAAK,SAAS;AACd,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,aAAO,KAAK,SAAS,MAAM;AAC3B,aAAO,KAAK,KAAK,MAAM,KAAK,QAAQ,QAAW,MAAM;AACnD,eAAO,IAAI,SAAS,MAAM;AAC1B,gBAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AACD,WAAO,GAAG,WAAW,CAAC,KAAa,UAAU;AAC3C,WAAK,WAAW,EAAE,SAAS,MAAM,SAAS,MAAM,MAAM,KAAK;AAC3D,YAAM,OAAsB;AAAA,QAC1B,MAAM;AAAA,QACN,IAAI,GAAG,MAAM,OAAO,IAAI,MAAM,IAAI;AAAA,QAClC,MAAM,KAAK,KAAK;AAAA,MAClB;AACA,YAAM,IAAkB,EAAE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,KAAK,WAAW,KAAK;AAChF,WAAK,SAAS,CAAC;AAAA,IACjB,CAAC;AACD,WAAO,GAAG,SAAS,CAAC,QAAQ,KAAK,KAAK,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC,CAAC;AAC5E,SAAK,KAAK,QAAQ,EAAE,QAAQ,MAAM,MAAM,KAAK,KAAK,CAAC;AAAA,EACrD;AAAA,EAEA,MAAM,KAAK,MAA6B;AACtC,UAAM,SAAS,KAAK;AACpB,UAAM,OAAO,KAAK;AAClB,QAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,uBAAuB;AACpD,QAAI,CAAC,KAAM,OAAM,IAAI,MAAM,kCAAkC;AAC7D,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,aAAO,KAAK,MAAM,KAAK,MAAM,KAAK,SAAS,CAAC,QAAS,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAE;AAAA,IACrF,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,OAAsB;AAC1B,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,UAAI,CAAC,KAAK,OAAQ,QAAO,QAAQ;AACjC,WAAK,OAAO,MAAM,MAAM,QAAQ,CAAC;AAAA,IACnC,CAAC;AACD,SAAK,SAAS;AAAA,EAChB;AACF;;;ACvHA,SAAS,kBAAkB;AAKpB,IAAM,eAAe;AAGrB,IAAM,kBAAN,cAA8B,WAAgC;AAAA,EAInE,YACmB,MACA,MACjB;AACA,UAAM;AAHW;AACA;AAGjB,SAAK,OAAO,EAAE,MAAM,UAAU,IAAI,MAAM,MAAM,UAAU,IAAI,IAAI,IAAI,GAAG;AAAA,EACzE;AAAA,EALmB;AAAA,EACA;AAAA,EALX;AAAA,EACS;AAAA,EAUjB,MAAM,QAAuB;AAC3B,UAAM,OAAO,IAAI,WAAW,EAAE,MAAM,KAAK,MAAM,UAAU,KAAK,KAAK,CAAC;AACpE,SAAK,OAAO;AACZ,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,WAAK,KAAK,QAAQ,OAAO;AACzB,WAAK,KAAK,SAAS,MAAM;AAAA,IAC3B,CAAC;AACD,SAAK,GAAG,QAAQ,CAAC,SAAiB;AAChC,YAAM,IAAkB,EAAE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,WAAW,KAAK,KAAK;AAChF,WAAK,SAAS,CAAC;AAAA,IACjB,CAAC;AACD,SAAK,GAAG,SAAS,MAAM,KAAK,KAAK,SAAS,EAAE,QAAQ,MAAM,MAAM,KAAK,KAAK,CAAC,CAAC;AAC5E,SAAK,GAAG,SAAS,CAAC,QAAQ,KAAK,KAAK,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC,CAAC;AAC1E,SAAK,KAAK,QAAQ,EAAE,QAAQ,MAAM,MAAM,KAAK,KAAK,CAAC;AAAA,EACrD;AAAA,EAEA,MAAM,KAAK,MAA6B;AACtC,QAAI,CAAC,KAAK,KAAM,OAAM,IAAI,MAAM,kBAAkB;AAClD,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,WAAK,KAAM,MAAM,MAAM,CAAC,QAAS,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAE;AAAA,IACjE,CAAC;AACD,UAAM,IAAkB,EAAE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,WAAW,KAAK,KAAK;AAChF,SAAK,SAAS,CAAC;AAAA,EACjB;AAAA,EAEA,MAAM,OAAsB;AAC1B,QAAI,CAAC,KAAK,KAAM;AAChB,UAAM,OAAO,KAAK;AAClB,SAAK,OAAO;AACZ,UAAM,IAAI,QAAc,CAAC,YAAY,KAAK,MAAM,MAAM,QAAQ,CAAC,CAAC;AAAA,EAClE;AACF;AAGA,eAAsB,kBAAsE;AAC1F,QAAM,QAAQ,MAAM,WAAW,KAAK;AACpC,SAAO,MAAM,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,EAAE,aAAa,EAAE;AAC1E;;;ACzCA,SAAS,UAAU,GAAmB;AACpC,MAAI,CAAC,QAAQ,KAAK,CAAC,EAAG,OAAM,IAAI,MAAM,iBAAiB,CAAC,GAAG;AAC3D,QAAM,IAAI,OAAO,CAAC;AAClB,MAAI,IAAI,KAAK,IAAI,MAAO,OAAM,IAAI,MAAM,sBAAsB,CAAC,GAAG;AAClE,SAAO;AACT;AAEA,SAAS,UAAU,GAAmB;AACpC,MAAI,CAAC,QAAQ,KAAK,CAAC,EAAG,OAAM,IAAI,MAAM,iBAAiB,CAAC,GAAG;AAC3D,QAAM,IAAI,OAAO,CAAC;AAClB,MAAI,IAAI,EAAG,OAAM,IAAI,MAAM,iBAAiB,CAAC,GAAG;AAChD,SAAO;AACT;AAGA,SAAS,cAAc,GAA2C;AAChE,MAAI;AACJ,MAAI;AACJ,MAAI,EAAE,WAAW,GAAG,GAAG;AACrB,UAAM,QAAQ,EAAE,QAAQ,GAAG;AAC3B,QAAI,QAAQ,EAAG,OAAM,IAAI,MAAM,sBAAsB,CAAC,GAAG;AACzD,WAAO,EAAE,MAAM,GAAG,KAAK;AACvB,cAAU,EAAE,MAAM,QAAQ,CAAC;AAC3B,QAAI,CAAC,QAAQ,WAAW,GAAG,EAAG,OAAM,IAAI,MAAM,sBAAsB,CAAC,GAAG;AACxE,cAAU,QAAQ,MAAM,CAAC;AAAA,EAC3B,OAAO;AACL,UAAM,IAAI,EAAE,YAAY,GAAG;AAC3B,QAAI,IAAI,EAAG,OAAM,IAAI,MAAM,oBAAoB,CAAC,GAAG;AACnD,WAAO,EAAE,MAAM,GAAG,CAAC;AACnB,cAAU,EAAE,MAAM,IAAI,CAAC;AAAA,EACzB;AACA,SAAO,EAAE,MAAM,MAAM,UAAU,OAAO,EAAE;AAC1C;AAGA,SAAS,YAAY,GAA2C;AAC9D,MAAI,CAAC,EAAE,SAAS,GAAG,EAAG,QAAO,EAAE,MAAM,IAAI,MAAM,UAAU,CAAC,EAAE;AAC5D,SAAO,cAAc,CAAC;AACxB;AAGA,SAAS,YAAY,GAA2C;AAC9D,QAAM,QAAQ,EAAE,MAAM,GAAG;AACzB,MAAI,MAAM,UAAU,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAE,GAAG;AAChD,WAAO,EAAE,MAAM,MAAM,CAAC,GAAI,MAAM,UAAU,MAAM,CAAC,CAAE,EAAE;AAAA,EACvD;AACA,SAAO,EAAE,MAAM,GAAG,MAAM,aAAa;AACvC;AAGO,SAAS,UAAU,MAA6B;AACrD,QAAM,MAAM,KAAK,QAAQ,GAAG;AAC5B,MAAI,MAAM,EAAG,OAAM,IAAI,MAAM,2BAA2B,IAAI,2BAA2B;AACvF,QAAM,SAAS,KAAK,MAAM,GAAG,GAAG;AAChC,QAAM,OAAO,KAAK,MAAM,MAAM,CAAC;AAE/B,UAAQ,QAAQ;AAAA,IACd,KAAK,UAAU;AACb,YAAM,EAAE,MAAM,KAAK,IAAI,YAAY,IAAI;AACvC,aAAO,EAAE,MAAM,UAAU,MAAM,MAAM,KAAK;AAAA,IAC5C;AAAA,IACA,KAAK,OAAO;AACV,YAAM,EAAE,MAAM,KAAK,IAAI,cAAc,IAAI;AACzC,aAAO,EAAE,MAAM,cAAc,MAAM,KAAK;AAAA,IAC1C;AAAA,IACA,KAAK,cAAc;AACjB,YAAM,EAAE,MAAM,KAAK,IAAI,YAAY,IAAI;AACvC,aAAO,EAAE,MAAM,cAAc,MAAM,KAAK;AAAA,IAC1C;AAAA,IACA,KAAK,OAAO;AACV,YAAM,EAAE,MAAM,KAAK,IAAI,cAAc,IAAI;AACzC,aAAO,EAAE,MAAM,OAAO,MAAM,KAAK;AAAA,IACnC;AAAA,IACA,KAAK,cAAc;AACjB,YAAM,EAAE,MAAM,KAAK,IAAI,YAAY,IAAI;AACvC,aAAO,EAAE,MAAM,cAAc,MAAM,KAAK;AAAA,IAC1C;AAAA,IACA;AACE,YAAM,IAAI,MAAM,6BAA6B,MAAM,GAAG;AAAA,EAC1D;AACF;AAGO,SAAS,OAAO,MAA6B;AAClD,UAAQ,KAAK,MAAM;AAAA,IACjB,KAAK;AACH,aAAO,UAAU,KAAK,IAAI,IAAI,KAAK,IAAI;AAAA,IACzC,KAAK;AACH,aAAO,OAAO,KAAK,IAAI,IAAI,KAAK,IAAI;AAAA,IACtC,KAAK;AACH,aAAO,cAAc,KAAK,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,GAAG,KAAK,IAAI;AAAA,IACnE,KAAK;AACH,aAAO,OAAO,KAAK,IAAI,IAAI,KAAK,IAAI;AAAA,IACtC,KAAK;AACH,aAAO,cAAc,KAAK,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,GAAG,KAAK,IAAI;AAAA,EACrE;AACF;AAGO,SAAS,gBAAgB,MAAgC;AAC9D,UAAQ,KAAK,MAAM;AAAA,IACjB,KAAK;AACH,aAAO,IAAI,gBAAgB,KAAK,MAAM,KAAK,IAAI;AAAA,IACjD,KAAK;AACH,aAAO,IAAI,mBAAmB,KAAK,MAAM,KAAK,IAAI;AAAA,IACpD,KAAK;AACH,aAAO,IAAI,mBAAmB,KAAK,MAAM,KAAK,IAAI;AAAA,IACpD,KAAK;AACH,aAAO,IAAI,aAAa,KAAK,MAAM,KAAK,IAAI;AAAA,IAC9C,KAAK;AACH,aAAO,IAAI,mBAAmB,KAAK,MAAM,KAAK,IAAI;AAAA,EACtD;AACF;;;AC7HO,SAAS,YAAY,GAAmB;AAC7C,QAAM,QAAQ,EAAE,QAAQ,QAAQ,EAAE,EAAE,QAAQ,UAAU,EAAE;AACxD,MAAI,MAAM,SAAS,MAAM,EAAG,OAAM,IAAI,MAAM,+BAA+B,CAAC,GAAG;AAC/E,MAAI,CAAC,eAAe,KAAK,KAAK,EAAG,OAAM,IAAI,MAAM,wBAAwB,CAAC,GAAG;AAC7E,QAAM,MAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACzC,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAK,KAAI,CAAC,IAAI,SAAS,MAAM,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;AACxF,SAAO;AACT;AAkBO,IAAM,UAAN,MAAc;AAAA,EACnB,YAA6B,MAAqB;AAArB;AAAA,EAAsB;AAAA,EAAtB;AAAA,EAE7B,QAAQ,GAA0B;AAChC,QAAI,KAAK,KAAK,OAAO,EAAE,QAAQ,KAAK,KAAK,IAAK,QAAO;AACrD,QAAI,KAAK,KAAK,OAAO,CAAC,EAAE,KAAK,SAAS,KAAK,KAAK,GAAG,EAAG,QAAO;AAC7D,QAAI,KAAK,KAAK,UAAU,CAAC,EAAE,KAAK,SAAS,KAAK,KAAK,MAAM,EAAG,QAAO;AACnE,QAAI,KAAK,KAAK,SAAS,CAAC,KAAK,KAAK,MAAM,KAAK,EAAE,KAAK,SAAS,MAAM,CAAC,EAAG,QAAO;AAC9E,WAAO;AAAA,EACT;AACF;;;ACvBO,IAAM,UAAN,MAAc;AAAA,EAInB,YACmB,QACA,OAAuB,CAAC,GACzC;AAFiB;AACA;AAEjB,SAAK,QAAQ,KAAK,SAAS,CAAC;AAAA,EAC9B;AAAA,EAJmB;AAAA,EACA;AAAA,EALF;AAAA,EACT,WAAW;AAAA,EASnB,MAAM,MAAqB;AACzB,SAAK,OAAO,GAAG,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;AAC9C,SAAK,OAAO,GAAG,SAAS,MAAM,KAAK,OAAO,CAAC;AAC3C,UAAM,KAAK,OAAO,MAAM;AAAA,EAC1B;AAAA,EAEQ,SAAS,GAAuB;AACtC,QAAI,KAAK,KAAK,UAAU,CAAC,KAAK,KAAK,OAAO,QAAQ,CAAC,EAAG;AACtD,eAAW,QAAQ,KAAK,MAAO,MAAK,QAAQ,CAAC;AAAA,EAC/C;AAAA,EAEQ,SAAe;AACrB,QAAI,KAAK,SAAU;AACnB,SAAK,WAAW;AAChB,eAAW,QAAQ,KAAK,MAAO,MAAK,QAAQ;AAAA,EAC9C;AAAA,EAEA,MAAM,OAAsB;AAC1B,UAAM,KAAK,OAAO,KAAK;AACvB,SAAK,OAAO;AAAA,EACd;AACF;;;ACpCO,IAAM,iBAAiB;AACvB,IAAM,YAAY;AAUlB,SAAS,aAAa,GAA0B;AACrD,SAAO,KAAK,UAAU;AAAA,IACpB,CAAC,SAAS,GAAG,EAAE;AAAA,IACf,MAAM,EAAE;AAAA,IACR,IAAI,EAAE;AAAA,IACN,MAAM,EAAE;AAAA,IACR,SAAS,EAAE;AAAA,EACb,CAAC;AACH;AAEO,SAAS,aAAa,MAA6B;AACxD,QAAM,IAAI,KAAK,MAAM,IAAI;AACzB,QAAM,UAAU,EAAE,SAAS;AAC3B,MAAI,OAAO,YAAY,UAAU;AAC/B,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AACA,MAAI,YAAY,gBAAgB;AAC9B,UAAM,IAAI,MAAM,wCAAwC,OAAO,EAAE;AAAA,EACnE;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,EAAE;AAAA,IACR,IAAI,OAAO,EAAE,MAAM,EAAE;AAAA,IACrB,MAAM,OAAO,EAAE,QAAQ,EAAE;AAAA,IACzB,SAAS,OAAO,EAAE,WAAW,CAAC;AAAA,EAChC;AACF;AAEO,SAAS,YAAY,GAAyB;AACnD,SAAO,KAAK,UAAU;AAAA,IACpB,GAAG,EAAE;AAAA,IACL,KAAK,EAAE;AAAA,IACP,MAAM,EAAE,UAAU;AAAA,IAClB,IAAI,EAAE,UAAU;AAAA,IAChB,MAAM,EAAE,UAAU;AAAA,IAClB,KAAK;AAAA,IACL,MAAM,EAAE,KAAK,SAAS,KAAK;AAAA,EAC7B,CAAC;AACH;AAEO,SAAS,YAAY,MAA4B;AACtD,QAAM,IAAI,KAAK,MAAM,IAAI;AACzB,MAAI,EAAE,QAAQ,MAAO,OAAM,IAAI,MAAM,iCAAiC,OAAO,EAAE,GAAG,CAAC,GAAG;AACtF,QAAM,MAAM,EAAE;AACd,MAAI,QAAQ,QAAQ,QAAQ,KAAM,OAAM,IAAI,MAAM,sBAAsB,OAAO,EAAE,GAAG,CAAC,GAAG;AACxF,SAAO;AAAA,IACL,IAAI,OAAO,EAAE,CAAC;AAAA,IACd;AAAA,IACA,MAAM,OAAO,KAAK,OAAO,EAAE,IAAI,GAAG,KAAK;AAAA,IACvC,WAAW;AAAA,MACT,MAAM,EAAE;AAAA,MACR,IAAI,OAAO,EAAE,MAAM,EAAE;AAAA,MACrB,MAAM,OAAO,EAAE,QAAQ,EAAE;AAAA,IAC3B;AAAA,EACF;AACF;;;ACnEO,IAAM,gBAAN,MAAoC;AAAA,EAGzC,YACmB,QACjB,QACA;AAFiB;AAGjB,SAAK,SAAS;AACd,SAAK,OAAO,MAAM,aAAa,MAAM,IAAI,IAAI;AAAA,EAC/C;AAAA,EALmB;AAAA,EAHF;AAAA,EAUjB,QAAQ,GAAuB;AAC7B,SAAK,OAAO,MAAM,YAAY,CAAC,IAAI,IAAI;AAAA,EACzC;AAAA,EAEA,UAAgB;AACd,SAAK,OAAO,IAAI;AAAA,EAClB;AACF;;;AC5BA,OAAO,QAAQ;AACf,OAAO,cAAc;AAOrB,IAAM,QAAQ,CAAC,OAAe,IAAI,QAAc,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAc7E,IAAM,aAAN,cAAyB,WAAiC;AAAA,EAK/D,YACmB,MACA,OAA0B,CAAC,GAC5C;AACA,UAAM;AAHW;AACA;AAIjB,SAAK,OAAO,EAAE,MAAM,UAAU,IAAI,MAAM,MAAM,KAAK;AAAA,EACrD;AAAA,EANmB;AAAA,EACA;AAAA,EANX,UAAU;AAAA,EACV;AAAA,EACS;AAAA,EAWjB,MAAM,QAAuB;AAC3B,SAAK,UAAU;AACf,UAAM,KAAK,SAAS,gBAAgB;AAAA,MAClC,OAAO,GAAG,iBAAiB,KAAK,IAAI;AAAA,MACpC,WAAW;AAAA,IACb,CAAC;AACD,SAAK,KAAK;AAEV,UAAM,QAAQ,KAAK,KAAK,SAAS;AACjC,QAAI;AACJ,QAAI;AAEJ,QAAI;AACF,uBAAiB,QAAQ,IAAI;AAC3B,YAAI,KAAK,QAAS;AAClB,YAAI,WAAW,QAAW;AACxB,mBAAS,aAAa,IAAI;AAC1B,eAAK,KAAK,QAAQ,EAAE,QAAQ,MAAM,MAAM,KAAK,WAAW,MAAM,EAAE,CAAC;AACjE;AAAA,QACF;AACA,cAAM,IAAI,YAAY,IAAI;AAC1B,YAAI,KAAK,KAAK,OAAO,EAAE,QAAQ,KAAK,KAAK,IAAK;AAC9C,YAAI,UAAU,UAAa,QAAQ,GAAG;AACpC,gBAAM,QAAQ,EAAE,KAAK,SAAS;AAC9B,cAAI,OAAO,EAAG,OAAM,MAAM,IAAI;AAAA,QAChC;AACA,gBAAQ,EAAE;AACV,aAAK,SAAS,CAAC;AAAA,MACjB;AAAA,IACF,UAAE;AACA,UAAI,CAAC,KAAK,SAAS;AACjB,aAAK,KAAK,SAAS,EAAE,QAAQ,MAAM,MAAM,KAAK,KAAK,CAAC;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,WAAW,GAAiC;AAClD,WAAO,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,IAAI,MAAM,EAAE,KAAK;AAAA,EAChD;AAAA,EAEA,MAAM,OAAsB;AAC1B,SAAK,UAAU;AACf,SAAK,IAAI,MAAM;AAAA,EACjB;AACF;;;ACzDO,IAAM,WAAN,MAA+B;AAAA,EAC5B,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,YAAY;AAAA,EAEpB,QAAQ,GAAuB;AAC7B,QAAI,KAAK,YAAY,EAAG,MAAK,UAAU,EAAE;AACzC,SAAK,SAAS,EAAE;AAChB,QAAI,EAAE,QAAQ,MAAM;AAClB,WAAK,WAAW,EAAE,KAAK;AACvB,WAAK;AAAA,IACP,OAAO;AACL,WAAK,WAAW,EAAE,KAAK;AACvB,WAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,UAAgB;AAAA,EAAC;AAAA,EAEjB,YAA4B;AAC1B,UAAM,aAAa,KAAK,IAAI,GAAG,KAAK,SAAS,KAAK,OAAO;AACzD,UAAM,OAAO,aAAa,OAAQ;AAClC,WAAO;AAAA,MACL,SAAS,KAAK;AAAA,MACd,QAAQ,KAAK;AAAA,MACb,SAAS,KAAK;AAAA,MACd,SAAS,KAAK;AAAA,MACd,WAAW,KAAK;AAAA,MAChB,WAAW,KAAK;AAAA,MAChB;AAAA,MACA,QAAQ,KAAK,UAAU;AAAA,MACvB,QAAQ,KAAK,UAAU;AAAA,MACvB,YAAY,KAAK,UAAU,KAAK,WAAW;AAAA,IAC7C;AAAA,EACF;AACF;;;AC7DA,OAAOA,SAAQ;AACf,OAAOC,eAAc;AAKrB,IAAMC,SAAQ,CAAC,OAAe,IAAI,QAAc,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAGpF,eAAsB,WAAW,MAAc,KAA0C;AACvF,QAAM,SAAyB,CAAC;AAChC,QAAM,KAAKC,UAAS,gBAAgB;AAAA,IAClC,OAAOC,IAAG,iBAAiB,IAAI;AAAA,IAC/B,WAAW;AAAA,EACb,CAAC;AACD,MAAI,aAAa;AACjB,mBAAiB,QAAQ,IAAI;AAC3B,QAAI,CAAC,YAAY;AACf,mBAAa,IAAI;AACjB,mBAAa;AACb;AAAA,IACF;AACA,UAAM,IAAI,YAAY,IAAI;AAC1B,QAAI,OAAO,EAAE,QAAQ,IAAK;AAC1B,WAAO,KAAK,CAAC;AAAA,EACf;AACA,SAAO;AACT;AAiBA,eAAsB,sBACpB,MACA,QACA,OAAsB,CAAC,GACN;AACjB,QAAM,SAAS,MAAM,WAAW,MAAM,KAAK,GAAG;AAC9C,QAAM,QAAQ,KAAK,SAAS;AAC5B,QAAM,QAAQ,OAAO;AACrB,MAAI,OAAO;AAEX,aAAS;AACP,QAAI;AACJ,eAAW,KAAK,QAAQ;AACtB,UAAI,UAAU,UAAa,QAAQ,GAAG;AACpC,cAAM,QAAQ,EAAE,KAAK,SAAS;AAC9B,YAAI,OAAO,EAAG,OAAMF,OAAM,IAAI;AAAA,MAChC;AACA,cAAQ,EAAE;AACV,YAAM,OAAO,KAAK,EAAE,IAAI;AACxB;AACA,WAAK,aAAa,MAAM,KAAK;AAAA,IAC/B;AACA,QAAI,CAAC,KAAK,KAAM;AAAA,EAClB;AAEA,SAAO;AACT;","names":["fs","readline","sleep","readline","fs"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@anthonyfree96/core",
+  "version": "0.1.0",
+  "description": "Engine for comm-scope: transport capture, recording, replay and analysis",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "serial",
+    "tcp",
+    "udp",
+    "traffic",
+    "replay",
+    "transport"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AndyFree96/comm-scope"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "serialport": "^13.0.0"
+  }
+}