@kar-mi/spirit-vale-tools-capture 3.0.0 → 3.0.1

package/dist/fishnet/replay.d.ts

@@ -0,0 +1,20 @@
+import type { DecodedFishNetPacket } from "./types.ts";
+export interface FishNetReplayLogRecord {
+    readonly type: string;
+    readonly recordedAt: string;
+    readonly data: Record<string, unknown>;
+}
+export type FishNetReplayRecordResult = "ignored" | "invalid" | "decoded";
+export interface FishNetTransportReplayStats {
+    datagrams: number;
+    decodeWarnings: number;
+}
+/** Replays structured UDP transport records through one connection-aware FishNet decoder. */
+export declare class FishNetTransportReplay {
+    private readonly session;
+    private datagrams;
+    private decodeWarnings;
+    consumeRecord(record: FishNetReplayLogRecord, consume: (packet: DecodedFishNetPacket, observedAtMs: number | undefined) => void): FishNetReplayRecordResult;
+    stats(): FishNetTransportReplayStats;
+}
+//# sourceMappingURL=replay.d.ts.map

package/dist/fishnet/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/fishnet/replay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,6FAA6F;AAC7F,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyD;IACjF,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,cAAc,CAAK;IAE3B,aAAa,CACX,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,CAAC,MAAM,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAChF,yBAAyB,CAmC3B;IAED,KAAK,IAAI,2BAA2B,CAEnC;CACF"}

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export type { FieldDecodeRun } from "./fishnet/decoding/fields.ts";
 export { characterDataParameter } from "./fishnet/schema/character-data.ts";
 export { decodeNetworkTransformData, NETWORK_TRANSFORM_RPC_NAMES } from "./fishnet/decoding/network-transform.ts";
 export { resolveBundledMapName } from "./fishnet/mapping/map-names.ts";
+export { FishNetTransportReplay } from "./fishnet/replay.ts";
+export type { FishNetReplayLogRecord, FishNetReplayRecordResult, FishNetTransportReplayStats, } from "./fishnet/replay.ts";
 export { compact, count, warnings } from "./text-format.ts";
 export type { BundledFishNetBuildFingerprint } from "./fishnet/mapping/bundled-rpc-map.ts";
 export { FishNetEternalTowerTracker } from "./fishnet/tracking/eternal-tower.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAClH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,YAAY,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,6BAA6B,EAC7B,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,EAC1B,gCAAgC,EAChC,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAClH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EACV,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,YAAY,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,6BAA6B,EAC7B,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,EAC1B,gCAAgC,EAChC,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -15307,6 +15307,61 @@ function characterDataParameter() {
   cached = parameter;
   return parameter;
 }
+// src/fishnet/replay.ts
+class FishNetTransportReplay {
+  session = new FishNetSessionDecoder(loadBundledFishNetRpcMap());
+  datagrams = 0;
+  decodeWarnings = 0;
+  consumeRecord(record, consume) {
+    if (record.type !== "transport.packet")
+      return "ignored";
+    const transport = parseUdpRecord(record.data);
+    if (!transport)
+      return "invalid";
+    this.datagrams += 1;
+    const source = `${transport.sourceIP}:${transport.sourcePort}`;
+    const destination = `${transport.destinationIP}:${transport.destinationPort}`;
+    const endpoints = [source, destination].sort();
+    const connectionBase = `${endpoints[0]}<->${endpoints[1]}`;
+    const direction = source === endpoints[0] ? "a-to-b" : "b-to-a";
+    const parsedAtMs = Date.parse(record.recordedAt);
+    const observedAtMs = Number.isFinite(parsedAtMs) ? parsedAtMs : undefined;
+    try {
+      for (const decoded of decodeLiteNetLibDatagram(Buffer.from(transport.payloadHex, "hex"))) {
+        const packet = decoded.packet;
+        const connectionId = `${connectionBase}#${packet.connectionNumber}`;
+        if (packet.property === "connectRequest" || packet.property === "connectAccept" || packet.property === "disconnect") {
+          this.session.reset(connectionId);
+          continue;
+        }
+        if (packet.property !== "unreliable" && packet.property !== "channeled" || packet.payload.length < 6)
+          continue;
+        for (const fishNetPacket of this.session.decode(packet.payload, {
+          reliable: packet.property === "channeled",
+          connectionId,
+          direction,
+          channel: packet.property === "channeled" ? packet.channel : 1,
+          sequence: packet.property === "channeled" ? packet.sequence : undefined
+        }))
+          consume(fishNetPacket, observedAtMs);
+      }
+    } catch {
+      this.decodeWarnings += 1;
+    }
+    return "decoded";
+  }
+  stats() {
+    return { datagrams: this.datagrams, decodeWarnings: this.decodeWarnings };
+  }
+}
+function parseUdpRecord(data) {
+  if (data["protocol"] !== "udp" || typeof data["sourceIP"] !== "string" || typeof data["destinationIP"] !== "string" || !isPort(data["sourcePort"]) || !isPort(data["destinationPort"]) || typeof data["payloadHex"] !== "string" || !/^(?:[0-9a-fA-F]{2})*$/.test(data["payloadHex"]))
+    return;
+  return data;
+}
+function isPort(value) {
+  return Number.isInteger(value) && value >= 0 && value <= 65535;
+}
 // src/text-format.ts
 function count(value, label) {
   return `${value} ${label}${value === 1 ? "" : "s"}`;
@@ -15494,6 +15549,7 @@ export {
   FishNetMonsterDirectory,
   FishNetProtocolError,
   FishNetSessionDecoder,
+  FishNetTransportReplay,
   LiteNetLibProtocolError,
   NETWORK_TRANSFORM_RPC_NAMES,
   characterDataParameter,

package/dist/text-format.d.ts

@@ -1,4 +1,7 @@
+/** @deprecated Import this application-facing helper from spirit-vale-tools-logging. */
 export declare function count(value: number, label: string): string;
+/** @deprecated Import this application-facing helper from spirit-vale-tools-logging. */
 export declare function compact(value: number | bigint): string;
+/** @deprecated Import this application-facing helper from spirit-vale-tools-logging. */
 export declare function warnings(value: number): string;
 //# sourceMappingURL=text-format.d.ts.map

package/dist/text-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-format.d.ts","sourceRoot":"","sources":["../src/text-format.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C"}
+{"version":3,"file":"text-format.d.ts","sourceRoot":"","sources":["../src/text-format.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wFAAwF;AACxF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEtD;AAED,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kar-mi/spirit-vale-tools-capture",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Passive Windows packet capture and Spirit Vale protocol decoding for Bun.",
   "license": "AGPL-3.0-only",
   "repository": {