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

package/dist/capture.js

@@ -1,5 +1,5 @@
 // @bun
-// src/fishnet/protocol.ts
+// src/fishnet/decoding/protocol.ts
 var PACKET_NAMES = new Map([
   [0, "unset"],
   [1, "authenticated"],
@@ -70,7 +70,7 @@ function unresolvedLinkPacket(buffer, start, tick, bundleIndex, packetId) {
   return packet;
 }
 
-// src/fishnet/wire-reader.ts
+// src/fishnet/decoding/wire-reader.ts
 function requireBytes(buffer, offset, count, description) {
   if (buffer.length - offset < count) {
     throw new FishNetProtocolError(`${description} needs ${count} bytes at byte ${offset}; ${buffer.length - offset} remain`);
@@ -277,7 +277,7 @@ function requireLength(bytes, offset, length, absoluteOffset, field) {
   }
 }
 
-// src/fishnet/rpc-definitions/generated/base-unit-controller.ts
+// src/fishnet/generated/rpc-map/base-unit-controller.ts
 var baseUnitControllerRpcs = [
   {
     wireHash: 0,
@@ -379,7 +379,7 @@ var baseUnitControllerRpcs = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/boss-grave-stone.ts
+// src/fishnet/generated/rpc-map/boss-grave-stone.ts
 var bossGraveStoneRpcs = [];
 var bossGraveStoneSyncTypes = [
   {
@@ -411,7 +411,7 @@ var bossGraveStoneSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/combat-component.ts
+// src/fishnet/generated/rpc-map/combat-component.ts
 var combatComponentRpcs = [
   {
     wireHash: 0,
@@ -516,7 +516,7 @@ var combatComponentSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/engine/network-animator.ts
+// src/fishnet/generated/rpc-map/engine/network-animator.ts
 var networkAnimatorRpcs = [
   {
     wireHash: 0,
@@ -542,7 +542,7 @@ var networkAnimatorRpcs = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/engine/predicted-owner.ts
+// src/fishnet/generated/rpc-map/engine/predicted-owner.ts
 var predictedOwnerRpcs = [
   {
     wireHash: 0,
@@ -558,7 +558,7 @@ var predictedOwnerRpcs = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/engine/network-transform.ts
+// src/fishnet/generated/rpc-map/engine/network-transform.ts
 var networkTransformRpcs = [
   {
     wireHash: 0,
@@ -651,7 +651,7 @@ var networkTransformRpcs = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/health-component.ts
+// src/fishnet/generated/rpc-map/health-component.ts
 var healthComponentRpcs = [
   {
     wireHash: 0,
@@ -748,7 +748,29 @@ var healthComponentRpcs = [
       },
       {
         name: "settings",
-        typeName: "FloaterSettings"
+        typeName: "FloaterSettings",
+        fields: [
+          {
+            name: "DisableFloater",
+            typeName: "System.Boolean",
+            codec: "boolean"
+          },
+          {
+            name: "DisableSfx",
+            typeName: "System.Boolean",
+            codec: "boolean"
+          },
+          {
+            name: "Offset",
+            typeName: "System.Int32",
+            codec: "packedInt32"
+          },
+          {
+            name: "Scale",
+            typeName: "System.Single",
+            codec: "float32"
+          }
+        ]
       }
     ]
   },
@@ -853,7 +875,7 @@ var healthComponentSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/loot-drop.ts
+// src/fishnet/generated/rpc-map/loot-drop.ts
 var lootDropRpcs = [];
 var lootDropSyncTypes = [
   {
@@ -917,7 +939,7 @@ var lootDropSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/monster-controller.ts
+// src/fishnet/generated/rpc-map/monster-controller.ts
 var monsterControllerRpcs = [
   {
     wireHash: 7,
@@ -1065,7 +1087,7 @@ var monsterControllerSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/move-component.ts
+// src/fishnet/generated/rpc-map/move-component.ts
 var moveComponentRpcs = [
   {
     wireHash: 0,
@@ -1129,7 +1151,7 @@ var moveComponentSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/player-controller.ts
+// src/fishnet/generated/rpc-map/player-controller.ts
 var playerControllerRpcs = [
   {
     wireHash: 7,
@@ -5354,7 +5376,7 @@ var playerControllerSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/player-save.ts
+// src/fishnet/generated/rpc-map/player-save.ts
 var playerSaveRpcs = [
   {
     wireHash: 0,
@@ -13024,7 +13046,7 @@ var playerSaveSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/skills-component.ts
+// src/fishnet/generated/rpc-map/skills-component.ts
 var skillsComponentRpcs = [
   {
     wireHash: 0,
@@ -13050,7 +13072,29 @@ var skillsComponentRpcs = [
       },
       {
         name: "settings",
-        typeName: "FloaterSettings"
+        typeName: "FloaterSettings",
+        fields: [
+          {
+            name: "DisableFloater",
+            typeName: "System.Boolean",
+            codec: "boolean"
+          },
+          {
+            name: "DisableSfx",
+            typeName: "System.Boolean",
+            codec: "boolean"
+          },
+          {
+            name: "Offset",
+            typeName: "System.Int32",
+            codec: "packedInt32"
+          },
+          {
+            name: "Scale",
+            typeName: "System.Single",
+            codec: "float32"
+          }
+        ]
       }
     ]
   },
@@ -13318,11 +13362,35 @@ var skillsComponentSyncTypes = [
   {
     index: 2,
     name: "BondSync",
-    typeName: "BondDto"
+    typeName: "BondDto",
+    fields: [
+      {
+        name: "Entries",
+        typeName: "System.Collections.Generic.List`1[[SkillsComponent+BondEntry, Assembly-CSharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null]]",
+        repeated: true,
+        fields: [
+          {
+            name: "Other",
+            typeName: "FishNet.Object.NetworkObject",
+            codec: "networkObject"
+          },
+          {
+            name: "SkillId",
+            typeName: "System.String",
+            codec: "stringUtf8Packed"
+          },
+          {
+            name: "Caster",
+            typeName: "System.Boolean",
+            codec: "boolean"
+          }
+        ]
+      }
+    ]
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/status-component.ts
+// src/fishnet/generated/rpc-map/status-component.ts
 var statusComponentRpcs = [
   {
     wireHash: 0,
@@ -13469,7 +13537,7 @@ var statusComponentSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/summoning-component.ts
+// src/fishnet/generated/rpc-map/summoning-component.ts
 var summoningComponentRpcs = [
   {
     wireHash: 0,
@@ -13584,7 +13652,7 @@ var summoningComponentSyncTypes = [
   }
 ];
 
-// src/fishnet/rpc-definitions/generated/broadcasts.ts
+// src/fishnet/generated/rpc-map/broadcasts.ts
 var GENERATED_BROADCASTS = [
   {
     wireHash: 40743,
@@ -13611,7 +13679,7 @@ var GENERATED_BROADCASTS = [
     typeName: "FishNet.Managing.Server.ConnectedClientsBroadcast"
   }
 ];
-// src/fishnet/rpc-definitions/generated/prefabs.ts
+// src/fishnet/generated/rpc-map/prefabs.ts
 var GENERATED_PREFAB_DEFINITIONS = [
   {
     collectionId: 0,
@@ -13772,11 +13840,11 @@ var GENERATED_PREFAB_DEFINITIONS = [
     ]
   }
 ];
-// src/fishnet/rpc-definitions/generated/manifest.ts
+// src/fishnet/generated/rpc-map/manifest.ts
 var GENERATED_BUILD_FINGERPRINT = "53305f369c4176d4b7644d06ad7f0cdc5c9bda6563144d0ce8cff3d12c520158";
 var GENERATED_METADATA_VERSION = 31;
 
-// src/fishnet/rpc-definitions/generated/index.ts
+// src/fishnet/generated/rpc-map/definitions.ts
 var GENERATED_BEHAVIOURS = [
   { typeName: "BaseUnitController", rpcs: baseUnitControllerRpcs },
   { typeName: "BossGraveStone", rpcs: bossGraveStoneRpcs, syncTypes: bossGraveStoneSyncTypes },
@@ -13795,7 +13863,7 @@ var GENERATED_BEHAVIOURS = [
   { typeName: "SummoningComponent", rpcs: summoningComponentRpcs, syncTypes: summoningComponentSyncTypes }
 ];
 
-// src/fishnet/rpc-definitions/index.ts
+// src/fishnet/generated/rpc-map/index.ts
 var FISHNET_RPC_MAP = {
   buildFingerprint: GENERATED_BUILD_FINGERPRINT,
   metadataVersion: GENERATED_METADATA_VERSION,
@@ -13810,7 +13878,7 @@ var BUNDLED_GAME_BUILD_FINGERPRINTS = [
   CURRENT_GAME_BUILD_FINGERPRINT
 ];
 
-// src/fishnet/builtin-maps.ts
+// src/fishnet/mapping/bundled-rpc-map.ts
 var MAPS = {
   [CURRENT_GAME_BUILD_FINGERPRINT]: FISHNET_RPC_MAP
 };
@@ -13824,7 +13892,7 @@ function isBundledFingerprint(value) {
   return Object.hasOwn(MAPS, value);
 }
 
-// src/fishnet/map-definitions/current-build.ts
+// src/fishnet/generated/map-names.current.ts
 var CURRENT_BUILD_MAP_NAMES = {
   1: "Nevaris",
   2: "Sunny Meadows 1",
@@ -13884,7 +13952,7 @@ var CURRENT_BUILD_MAP_NAMES = {
   56: "Jail"
 };
 
-// src/fishnet/map-definitions/index.ts
+// src/fishnet/mapping/map-names.ts
 var MAPS2 = {
   [CURRENT_GAME_BUILD_FINGERPRINT]: CURRENT_BUILD_MAP_NAMES
 };
@@ -13892,7 +13960,7 @@ function resolveBundledMapName(mapId, buildFingerprint = CURRENT_GAME_BUILD_FING
   return MAPS2[buildFingerprint]?.[mapId];
 }
 
-// src/fishnet/field-decoder.ts
+// src/fishnet/decoding/fields.ts
 function applyDecodedFields(packet, parameters, startOffset = 0) {
   if (!parameters || parameters.length === 0)
     return;
@@ -14128,7 +14196,7 @@ function decodeField(buffer, offset, codec) {
   }
 }
 
-// src/fishnet/quaternion-compression.ts
+// src/fishnet/decoding/quaternion.ts
 var MAXIMUM = 1 / 1.414214;
 var SCALE_10_BIT = (1 << 9) - 1;
 var SCALE_21_BIT = (1 << 20) - 1;
@@ -14182,7 +14250,7 @@ function quaternionYaw(quaternion) {
   return Math.atan2(2 * (w * y + x * z), 1 - 2 * (y * y + x * x));
 }
 
-// src/fishnet/network-transform-decoder.ts
+// src/fishnet/decoding/network-transform.ts
 var COMPRESSED_SCALE = 100;
 var ROTATION_WIDTHS = [16, 8, 4];
 var AXIS_FLAGS = [
@@ -14303,7 +14371,94 @@ var NETWORK_TRANSFORM_RPC_NAMES = new Set([
   "ServerUpdateTransform"
 ]);
 
-// src/fishnet/rpc-resolution.ts
+// src/fishnet/mapping/rpc-map.ts
+function lookupRpc(map, networkBehaviourType, packetName, hash8, hash16) {
+  if (!map)
+    return { resolution: "unresolved" };
+  const hashes = new Set([hash8, ...hash16 === undefined ? [] : [hash16]]);
+  const behaviours = networkBehaviourType ? map.behaviours.filter(({ typeName }) => typeName === networkBehaviourType) : map.behaviours;
+  const matches = behaviours.flatMap(({ typeName, rpcs }) => rpcs.filter((rpc) => rpc.packetKind === packetName && hashes.has(rpc.wireHash)).map((rpc) => ({ ...rpc, typeName })));
+  return definitionLookup(matches);
+}
+function signatureAdmitsPayload(lookup, payload) {
+  const fit = tryDecodeFields(payload, lookup.parameters);
+  return fit.undecodable || fit.complete && (fit.consumed === payload.length || admitsVerifiedPrefix(lookup.parameters));
+}
+function admitsVerifiedPrefix(parameters) {
+  return parameters?.at(-1)?.prefix === true;
+}
+function rejectedByPayload(packet, lookup) {
+  return lookup.resolution === "verified" && !signatureAdmitsPayload(lookup, packet.payload);
+}
+function applyRpcLookup(packet, lookup) {
+  if (rejectedByPayload(packet, lookup)) {
+    packet.rpcResolution = "unresolved";
+    return;
+  }
+  packet.rpcResolution = lookup.resolution;
+  if (lookup.resolution !== "verified")
+    return;
+  packet.rpcName = lookup.methodName;
+  applyDecodedFields(packet, lookup.parameters);
+  applyNetworkTransform(packet);
+}
+function applyNetworkTransform(packet) {
+  if (packet.rpcName === undefined || !NETWORK_TRANSFORM_RPC_NAMES.has(packet.rpcName))
+    return;
+  const update = decodeNetworkTransformData(packet.payload);
+  if (!update)
+    return;
+  packet.networkTransform = update;
+  const fields = [];
+  for (const [axis, value] of Object.entries(update.position)) {
+    if (value !== undefined)
+      fields.push({ name: `position.${axis}`, typeName: "System.Single", codec: "float32", value });
+  }
+  for (const [axis, value] of Object.entries(update.scale ?? {})) {
+    if (value !== undefined)
+      fields.push({ name: `scale.${axis}`, typeName: "System.Single", codec: "float32", value });
+  }
+  if (fields.length > 0)
+    packet.decodedFields = [...packet.decodedFields ?? [], ...fields];
+  packet.undecodedPayload = update.consumed < packet.payload.length ? packet.payload.subarray(update.consumed) : undefined;
+}
+function findBroadcast(map, wireHash) {
+  if (!map)
+    return;
+  const matches = (map.broadcasts ?? []).filter((broadcast) => broadcast.wireHash === wireHash);
+  return matches.length === 1 ? matches[0] : undefined;
+}
+function findSyncType(map, typeName, index) {
+  if (!map || !typeName)
+    return;
+  const matches = map.behaviours.filter((behaviour) => behaviour.typeName === typeName).flatMap((behaviour) => behaviour.syncTypes ?? []).filter((sync) => sync.index === index);
+  return matches.length === 1 ? matches[0] : undefined;
+}
+function findPrefab(map, collectionId, prefabId) {
+  if (!map?.prefabs)
+    return;
+  const matches = map.prefabs.filter((layout) => layout.collectionId === collectionId && layout.prefabId === prefabId);
+  return matches.length === 1 ? matches[0] : undefined;
+}
+function definitionLookup(matches) {
+  const wireHashes = new Set(matches.map(({ wireHash }) => wireHash));
+  if (matches.length === 1 && matches[0]) {
+    return {
+      resolution: "verified",
+      wireHash: matches[0].wireHash,
+      methodName: matches[0].methodName,
+      parameters: matches[0].parameters
+    };
+  }
+  const ambiguousBehaviourTypes = matches.length > 1 ? [...new Set(matches.map(({ typeName }) => typeName).filter((typeName) => typeName !== undefined))] : undefined;
+  return {
+    resolution: matches.length > 1 ? "ambiguous" : "unresolved",
+    ambiguousBehaviourTypes: ambiguousBehaviourTypes?.length ? ambiguousBehaviourTypes : undefined,
+    wireHash: wireHashes.size === 1 ? wireHashes.values().next().value : undefined
+  };
+}
+
+// src/fishnet/inference/rpc-inference.ts
 function bindBehaviourTypes(registrations, map) {
   if (!map)
     return [];
@@ -14365,19 +14520,9 @@ function inferBehaviourType(map, packetName, hash8, hash16) {
   if (!map)
     return;
   const hashes = new Set([hash8, ...hash16 === undefined ? [] : [hash16]]);
-  const matches = map.behaviours.filter(({ rpcs }) => {
-    return rpcs.some((rpc) => rpc.packetKind === packetName && hashes.has(rpc.wireHash));
-  });
+  const matches = map.behaviours.filter(({ rpcs }) => rpcs.some((rpc) => rpc.packetKind === packetName && hashes.has(rpc.wireHash)));
   return matches.length === 1 ? matches[0]?.typeName : undefined;
 }
-function lookupRpc(map, networkBehaviourType, packetName, hash8, hash16) {
-  if (!map)
-    return { resolution: "unresolved" };
-  const hashes = new Set([hash8, ...hash16 === undefined ? [] : [hash16]]);
-  const behaviours = networkBehaviourType ? map.behaviours.filter(({ typeName }) => typeName === networkBehaviourType) : map.behaviours;
-  const matches = behaviours.flatMap(({ typeName, rpcs }) => rpcs.filter((rpc) => rpc.packetKind === packetName && hashes.has(rpc.wireHash)).map((rpc) => ({ ...rpc, typeName })));
-  return definitionLookup(matches);
-}
 function eliminateBoundBehaviourTypes(components, objectId, componentIndex, candidates) {
   const selfKey = componentKey(objectId, componentIndex);
   const prefix = `${objectId}:`;
@@ -14438,94 +14583,17 @@ function eliminateByPayloadShape(map, candidates, packetName, hash8, hash16, pay
       const fit = tryDecodeFields(payload, rpc.parameters);
       if (fit.undecodable)
         return;
-      if (fit.complete && (fit.consumed === payload.length || admitsVerifiedPrefix(rpc.parameters)))
+      if (fit.complete && (fit.consumed === payload.length || rpc.parameters?.at(-1)?.prefix === true))
         fitting.add(typeName);
     }
   }
   return fitting.size === 1 ? [...fitting][0] : undefined;
 }
-function signatureAdmitsPayload(lookup, payload) {
-  const fit = tryDecodeFields(payload, lookup.parameters);
-  return fit.undecodable || fit.complete && (fit.consumed === payload.length || admitsVerifiedPrefix(lookup.parameters));
-}
-function admitsVerifiedPrefix(parameters) {
-  return parameters?.at(-1)?.prefix === true;
-}
-function rejectedByPayload(packet, lookup) {
-  return lookup.resolution === "verified" && !signatureAdmitsPayload(lookup, packet.payload);
-}
-function applyRpcLookup(packet, lookup) {
-  if (rejectedByPayload(packet, lookup)) {
-    packet.rpcResolution = "unresolved";
-    return;
-  }
-  packet.rpcResolution = lookup.resolution;
-  if (lookup.resolution !== "verified")
-    return;
-  packet.rpcName = lookup.methodName;
-  applyDecodedFields(packet, lookup.parameters);
-  applyNetworkTransform(packet);
-}
-function applyNetworkTransform(packet) {
-  if (packet.rpcName === undefined || !NETWORK_TRANSFORM_RPC_NAMES.has(packet.rpcName))
-    return;
-  const update = decodeNetworkTransformData(packet.payload);
-  if (!update)
-    return;
-  packet.networkTransform = update;
-  const fields = [];
-  for (const [axis, value] of Object.entries(update.position)) {
-    if (value !== undefined)
-      fields.push({ name: `position.${axis}`, typeName: "System.Single", codec: "float32", value });
-  }
-  for (const [axis, value] of Object.entries(update.scale ?? {})) {
-    if (value !== undefined)
-      fields.push({ name: `scale.${axis}`, typeName: "System.Single", codec: "float32", value });
-  }
-  if (fields.length > 0)
-    packet.decodedFields = [...packet.decodedFields ?? [], ...fields];
-  packet.undecodedPayload = update.consumed < packet.payload.length ? packet.payload.subarray(update.consumed) : undefined;
-}
-function findBroadcast(map, wireHash) {
-  if (!map)
-    return;
-  const matches = (map.broadcasts ?? []).filter((broadcast) => broadcast.wireHash === wireHash);
-  return matches.length === 1 ? matches[0] : undefined;
-}
-function findSyncType(map, typeName, index) {
-  if (!map || !typeName)
-    return;
-  const matches = map.behaviours.filter((behaviour) => behaviour.typeName === typeName).flatMap((behaviour) => behaviour.syncTypes ?? []).filter((sync) => sync.index === index);
-  return matches.length === 1 ? matches[0] : undefined;
-}
 function rpcFingerprint(values) {
   return values.map(({ wireHash, packetKind }) => `${wireHash}:${packetKind}`).sort().join(",");
 }
-function definitionLookup(matches) {
-  const wireHashes = new Set(matches.map(({ wireHash }) => wireHash));
-  if (matches.length === 1 && matches[0]) {
-    return {
-      resolution: "verified",
-      wireHash: matches[0].wireHash,
-      methodName: matches[0].methodName,
-      parameters: matches[0].parameters
-    };
-  }
-  const ambiguousBehaviourTypes = matches.length > 1 ? [...new Set(matches.map(({ typeName }) => typeName).filter((typeName) => typeName !== undefined))] : undefined;
-  return {
-    resolution: matches.length > 1 ? "ambiguous" : "unresolved",
-    ambiguousBehaviourTypes: ambiguousBehaviourTypes?.length ? ambiguousBehaviourTypes : undefined,
-    wireHash: wireHashes.size === 1 ? wireHashes.values().next().value : undefined
-  };
-}
-function findPrefab(map, collectionId, prefabId) {
-  if (!map?.prefabs)
-    return;
-  const matches = map.prefabs.filter((layout) => layout.collectionId === collectionId && layout.prefabId === prefabId);
-  return matches.length === 1 ? matches[0] : undefined;
-}
 
-// src/fishnet/spawn-parser.ts
+// src/fishnet/decoding/spawn.ts
 function parseObjectSpawn(buffer, start, map) {
   try {
     requireBytes(buffer, start, 1, "spawn flags");
@@ -14676,7 +14744,7 @@ function parseLinkRegistrations(buffer, start, end, objectId) {
   return offset === end ? registrations : undefined;
 }
 
-// src/fishnet/message-parser.ts
+// src/fishnet/decoding/messages.ts
 function parseMessage(buffer, start, tick, bundleIndex, state, options) {
   const packetId = buffer.readUInt16LE(start);
   const packetName = classifyPacket(packetId);
@@ -15005,7 +15073,7 @@ function finish(entries) {
   return entries.length > 0 ? entries : undefined;
 }
 
-// src/fishnet/session-decoder.ts
+// src/fishnet/decoding/session.ts
 var MAX_SPLIT_CHUNKS = 1024;
 var MAX_SPLIT_BYTES = 1024 * 1024;
 var MAX_CONCURRENT_SPLITS_PER_CONNECTION = 32;
@@ -15181,7 +15249,7 @@ function removeObjectComponents(state, objectId) {
   }
 }
 
-// src/fishnet/decoder.ts
+// src/fishnet/decoding/decoder.ts
 function decodeFishNetPayload(payload, options = { reliable: false }) {
   if (payload.length < 6) {
     throw new FishNetProtocolError(`FishNet payload needs a 4-byte tick and 2-byte packet id; received ${payload.length} bytes`);
@@ -15452,6 +15520,120 @@ function isUsable(device) {
   return !device.loopback && device.addresses.length > 0 && !["bluetooth", "wan miniport", "vmware", "hyper-v", "zerotier"].some((value) => label.includes(value));
 }
 
+// src/capture/duplicate-filter.ts
+var DUPLICATE_WINDOW_MS = 5;
+var DUPLICATE_ENTRY_LIMIT = 16384;
+
+class DuplicateFilter {
+  windowMs;
+  entryLimit;
+  seen = new Map;
+  suppressed = 0;
+  constructor(options = {}) {
+    this.windowMs = options.windowMs ?? DUPLICATE_WINDOW_MS;
+    this.entryLimit = options.entryLimit ?? DUPLICATE_ENTRY_LIMIT;
+  }
+  get suppressedCount() {
+    return this.suppressed;
+  }
+  admit(packet, nowMs = Date.now()) {
+    if (packet.payload.length === 0)
+      return true;
+    const key = digest(packet.protocol, packet.direction, localPortOf(packet), packet.payload);
+    const previous = this.seen.get(key);
+    if (previous !== undefined && nowMs - previous < this.windowMs) {
+      this.suppressed += 1;
+      return false;
+    }
+    this.seen.delete(key);
+    this.seen.set(key, nowMs);
+    this.evict(nowMs);
+    return true;
+  }
+  takeSuppressedCount() {
+    const total = this.suppressed;
+    this.suppressed = 0;
+    return total;
+  }
+  reset() {
+    this.seen.clear();
+    this.suppressed = 0;
+  }
+  evict(nowMs) {
+    const cutoff = nowMs - this.windowMs;
+    for (const [key, observedAt] of this.seen) {
+      if (observedAt >= cutoff && this.seen.size <= this.entryLimit)
+        break;
+      this.seen.delete(key);
+    }
+  }
+}
+function digest(protocol, direction, localPort, payload) {
+  return `${protocol}:${direction}:${localPort}:${payload.toString("latin1")}`;
+}
+function localPortOf(packet) {
+  return packet.direction === "outbound" ? packet.sourcePort : packet.destinationPort;
+}
+
+// src/capture/drop-diagnostics.ts
+var DROP_FLOW_LIMIT = 64;
+var DROP_FLOW_REPORT_COUNT = 5;
+var DROP_VERDICT_MIN_SAMPLES = 20;
+var DROP_VERDICT_THRESHOLD = 0.25;
+
+class DropDiagnostics {
+  flows = new Map;
+  record(packet) {
+    const flow = flowName(packet);
+    let stats = this.flows.get(flow);
+    if (!stats) {
+      if (this.flows.size >= DROP_FLOW_LIMIT)
+        return;
+      stats = { packets: 0, sequenced: 0, consecutive: 0 };
+      this.flows.set(flow, stats);
+    }
+    stats.packets += 1;
+    this.countSequence(stats, packet);
+  }
+  topFlows(limit = DROP_FLOW_REPORT_COUNT) {
+    return [...this.flows].sort(([, a], [, b]) => b.packets - a.packets).slice(0, limit).map(([flow, stats]) => ({ flow, packets: stats.packets, verdict: verdictFor(stats) }));
+  }
+  get hasGameTraffic() {
+    return [...this.flows.values()].some((stats) => verdictFor(stats) === "game traffic");
+  }
+  reset() {
+    this.flows.clear();
+  }
+  countSequence(stats, packet) {
+    if (packet.protocol !== "udp" || packet.payload.length === 0)
+      return;
+    let decoded;
+    try {
+      decoded = decodeLiteNetLibDatagram(packet.payload);
+    } catch {
+      return;
+    }
+    for (const { packet: inner } of decoded) {
+      const sequence = "sequence" in inner ? inner.sequence : undefined;
+      if (sequence === undefined)
+        continue;
+      stats.sequenced += 1;
+      if (stats.previous !== undefined && sequence === (stats.previous + 1) % 32768) {
+        stats.consecutive += 1;
+      }
+      stats.previous = sequence;
+    }
+  }
+}
+function verdictFor(stats) {
+  if (stats.sequenced < DROP_VERDICT_MIN_SAMPLES)
+    return "unknown";
+  return stats.consecutive / stats.sequenced >= DROP_VERDICT_THRESHOLD ? "game traffic" : "unrelated";
+}
+function flowName(packet) {
+  return `${packet.protocol} ${packet.sourceIP}:${packet.sourcePort} -> ${packet.destinationIP}:${packet.destinationPort}`;
+}
+
 // src/capture/link-layer.ts
 var DATA_LINK = {
   NULL: 0,
@@ -15928,6 +16110,7 @@ var MAX_POLL_BATCH = 128;
 var PENDING_PACKET_LIMIT = 16384;
 var PENDING_PACKET_MAX_AGE_MS = TARGET_REFRESH_INTERVAL_MS * 5;
 var PENDING_DROP_REPORT_MS = 1e4;
+var DUPLICATE_REPORT_MS = 1e4;
 var systemRuntime = new SystemNpcapRuntime;
 async function getNpcapStatus() {
   return systemRuntime.status();
@@ -15952,6 +16135,11 @@ class PacketCapture extends EventEmitter {
   currentConnectionId;
   droppedPending = 0;
   droppedReportedAtMs = 0;
+  duplicateFilter = null;
+  duplicateReportedAtMs = 0;
+  relayObserved = false;
+  dropDiagnostics = new DropDiagnostics;
+  deviceLabel = "";
   _state = "stopped";
   constructor(dependencies = {}) {
     super();
@@ -15987,10 +16175,12 @@ class PacketCapture extends EventEmitter {
       this.decodeLiteNetLib = (config.decodeLiteNetLib ?? false) || decodeFishNet;
       this.fishNetRpcMap = decodeFishNet ? config.fishNetRpcMap ?? loadBundledFishNetRpcMap(config.fishNetBuildFingerprint) : undefined;
       this.fishNetSessionDecoder = decodeFishNet ? new FishNetSessionDecoder(this.fishNetRpcMap) : null;
+      this.duplicateFilter = config.suppressDuplicates ?? true ? new DuplicateFilter : null;
       const devices = await this.runtime.listDevices();
       const resolved = await resolveCaptureDevice(devices, config.deviceName);
       if (!resolved.device)
         throw new Error("Npcap did not report a usable network adapter");
+      this.deviceLabel = resolved.device.description || resolved.device.name;
       const filter = config.filter ?? Array.from(new Set(protocols)).join(" or ");
       this.session = await this.runtime.open(resolved.device, filter);
       if (!supportsDataLink(this.session.dataLink)) {
@@ -16027,6 +16217,7 @@ class PacketCapture extends EventEmitter {
     this.polling = true;
     try {
       this.flushPending();
+      this.reportSuppressedDuplicates();
       for (let index = 0;index < MAX_POLL_BATCH; index += 1) {
         const captured = this.session.nextPacket();
         if (!captured)
@@ -16054,7 +16245,7 @@ class PacketCapture extends EventEmitter {
             this.emitTransportPacket(packet);
           } else {
             if (this.pending.length >= PENDING_PACKET_LIMIT)
-              this.droppedPending += 1;
+              this.recordDropped(packet);
             else
               this.pending.push({ packet, observedAt: Date.now() });
           }
@@ -16071,6 +16262,10 @@ class PacketCapture extends EventEmitter {
       this.polling = false;
     }
   }
+  recordDropped(packet) {
+    this.droppedPending += 1;
+    this.dropDiagnostics.record(packet);
+  }
   flushPending() {
     if (!this.target)
       return;
@@ -16082,7 +16277,7 @@ class PacketCapture extends EventEmitter {
     const remaining = [];
     for (const candidate of this.pending) {
       if (candidate.observedAt < cutoff) {
-        this.droppedPending += 1;
+        this.recordDropped(candidate.packet);
         continue;
       }
       const direction = this.target.classify(candidate.packet);
@@ -16096,6 +16291,17 @@ class PacketCapture extends EventEmitter {
     this.pending = remaining;
     this.reportDroppedPending();
   }
+  reportSuppressedDuplicates() {
+    if (!this.duplicateFilter || this.duplicateFilter.suppressedCount === 0)
+      return;
+    const now = Date.now();
+    this.duplicateReportedAtMs ||= now;
+    if (now - this.duplicateReportedAtMs < DUPLICATE_REPORT_MS)
+      return;
+    const total = this.duplicateFilter.takeSuppressedCount();
+    this.emitSafely("warning", `suppressed ${total} duplicate packets on ${this.deviceLabel}; a VPN or proxy is relaying this traffic` + ", so select the adapter carrying it directly if decoding looks incomplete");
+    this.duplicateReportedAtMs = now;
+  }
   reportDroppedPending() {
     if (this.droppedPending === 0)
       return;
@@ -16103,11 +16309,20 @@ class PacketCapture extends EventEmitter {
     this.droppedReportedAtMs ||= now;
     if (now - this.droppedReportedAtMs < PENDING_DROP_REPORT_MS)
       return;
-    this.emitSafely("warning", `gave up on ${this.droppedPending} packets that could not be attributed to the target process`);
+    const relay = this.relayObserved ? "; a VPN or proxy is also relaying traffic on this adapter" : "";
+    this.emitSafely("warning", `gave up on ${this.droppedPending} packets that could not be attributed to the target process${relay}`);
+    this.emitSafely("droppedFlows", this.dropDiagnostics.topFlows());
+    if (this.dropDiagnostics.hasGameTraffic) {
+      this.emitSafely("warning", "some discarded traffic carries sequenced game packets, so the target process does not own" + " every socket its traffic uses; capture that adapter directly or report these flows");
+    }
     this.droppedPending = 0;
     this.droppedReportedAtMs = now;
   }
   emitTransportPacket(packet) {
+    if (this.duplicateFilter && !this.duplicateFilter.admit(packet)) {
+      this.relayObserved = true;
+      return;
+    }
     if (packet.protocol === "tcp")
       this.emitSafely("packet", packet);
     else
@@ -16207,12 +16422,18 @@ class PacketCapture extends EventEmitter {
     this.currentConnectionId = undefined;
     this.droppedPending = 0;
     this.droppedReportedAtMs = 0;
+    this.duplicateFilter?.reset();
+    this.duplicateFilter = null;
+    this.duplicateReportedAtMs = 0;
+    this.relayObserved = false;
+    this.dropDiagnostics.reset();
+    this.deviceLabel = "";
   }
 }
 function connectionIdFor(packet) {
   const udp = packet.udpPacket;
-  const endpoints = [`${udp.sourceIP}:${udp.sourcePort}`, `${udp.destinationIP}:${udp.destinationPort}`].sort();
-  return `${endpoints[0]}<->${endpoints[1]}#${packet.packet.connectionNumber}`;
+  const localPort = udp.direction === "outbound" ? udp.sourcePort : udp.destinationPort;
+  return `local:${localPort}#${packet.packet.connectionNumber}`;
 }
 function inferDirection(ipPacket, device) {
   if (ipPacket[0] >> 4 === 4 && ipPacket.length >= 20) {