@kar-mi/spirit-vale-tools-combat 3.3.5

package/README.md

@@ -0,0 +1,56 @@
+# @kar-mi/spirit-vale-tools-combat
+
+Spirit Vale combat event tracking and replay utilities.
+
+## Install
+
+```sh
+bun add @kar-mi/spirit-vale-tools-combat
+```
+
+## Usage
+
+```ts
+import { FishNetCombatTracker, LiveCombatService } from "@kar-mi/spirit-vale-tools-combat";
+
+const tracker = new FishNetCombatTracker();
+const meter = new LiveCombatService({ personalName: "MyCharacter" });
+
+// packet: DecodedFishNetPacket from @kar-mi/spirit-vale-tools-capture
+for (const event of tracker.consume(packet)) {
+  meter.consumeCombat(event, Date.now());
+}
+
+const { current } = meter.getState();
+if (current) console.log(current.dps.partyDps, current.dps.actors);
+```
+
+To build encounters yourself rather than through the live service, drive
+`DamageReducer` and render each finished encounter with `renderEncounter`.
+
+Feed the tracker every decoded FishNet packet from live capture or replay. Use
+`FishNetActorDirectory` to resolve actor identities and `loadDpsReplay` /
+`DpsSessionLogFollower` to rebuild encounters from recorded log sessions.
+
+`DpsSessionLogFollower` can be followed rather than polled, which is what an
+overlay should do — it wakes on a filesystem event instead of on a timer, and
+yields only batches that carry something:
+
+```ts
+const follower = DpsSessionLogFollower.watch();
+for await (const batch of follower) {
+  if (batch.changed) apply(batch.events);
+}
+follower.close();
+```
+
+Each batch carries `changed` and `revision`, so a consumer can skip re-projecting
+when the reducer state did not move. `FishNetStatusTracker` exposes the same
+`revision` alongside `nextExpiryAtMs()`, which says when the next status is due
+to lapse — enough to sleep until a chip actually disappears rather than ticking.
+
+For bounded live UI state, use `LiveCombatService`. It exposes the current and
+latest finished encounter with DPS, incoming damage-per-second (TPS), and
+healing-per-second (HPS) rows without retaining the full session history.
+
+See the [package guide](https://github.com/kar-mi/spirit-vale-tools/blob/main/docs/packages.md) for registry setup and usage.

package/dist/actor-directory.d.ts

@@ -0,0 +1,88 @@
+import type { DecodedFishNetPacket } from "@kar-mi/spirit-vale-tools-capture";
+export interface FishNetActorIdentity {
+    readonly actorId: number;
+    readonly displayName: string;
+    readonly archetype?: number;
+    /** Session-local FishNet owner used to group related player objects. */
+    readonly ownerConnectionId?: number;
+    readonly uid?: string;
+}
+export interface FishNetActorIdentityUpsertEvent extends FishNetActorIdentity {
+    kind: "actorIdentity";
+    operation: "upsert";
+    tick: number;
+}
+export interface FishNetActorIdentityRemoveEvent {
+    kind: "actorIdentity";
+    operation: "remove";
+    tick: number;
+    actorId: number;
+}
+export interface FishNetActorIdentityResetEvent {
+    kind: "actorIdentity";
+    operation: "reset";
+    tick: number;
+}
+export type FishNetActorIdentityEvent = FishNetActorIdentityUpsertEvent | FishNetActorIdentityRemoveEvent | FishNetActorIdentityResetEvent;
+export interface FishNetLocalIdentity {
+    displayName: string;
+    uid?: string;
+    archetype?: number;
+    accountId?: string;
+}
+/** A durable, uid-keyed identity learned in a prior session, used to seed a fresh directory. */
+export interface FishNetKnownIdentity {
+    readonly uid: string;
+    readonly displayName: string;
+    readonly archetype?: number;
+}
+export interface FishNetActorDirectoryOptions {
+    /** Persisted local-player identity. */
+    localIdentity?: FishNetLocalIdentity;
+    /** Invoked whenever the local player's identity is decoded from CharacterData RPCs. */
+    onLocalIdentity?: (identity: FishNetLocalIdentity) => void;
+    knownIdentities?: readonly FishNetKnownIdentity[];
+    /** Invoked whenever a uid's cached displayName/archetype is newly learned or changed. */
+    onIdentityLearned?: (identity: FishNetKnownIdentity) => void;
+}
+/** Tracks public display names by the FishNet object IDs used by combat events. */
+export declare class FishNetActorDirectory {
+    private readonly options;
+    private readonly identities;
+    private readonly objects;
+    private readonly ownerObjects;
+    private readonly identitySources;
+    private readonly sourceRevisions;
+    /** Combat attacker IDs that should inherit the identity of another object with the same owner. */
+    private readonly observedPlayerActors;
+    /** UID-keyed names survive map-change resets when delta respawns repeat the UID. */
+    private readonly uidIdentities;
+    private nextSourceRevision;
+    private localIdentity?;
+    constructor(options?: FishNetActorDirectoryOptions);
+    consume(packet: DecodedFishNetPacket): FishNetActorIdentityEvent[];
+    private applyIdentitySource;
+    get(actorId: number): FishNetActorIdentity | undefined;
+    /** Resolves a combat attacker even when the hit came from a newly allocated player object. */
+    getAttribution(actorId: number): FishNetActorIdentity | undefined;
+    /** Snapshots every currently known identity, for seeding a freshly rotated log with resolved names. */
+    snapshot(): FishNetActorIdentity[];
+    /** Marks an attacker ID from a player-team combat event as eligible for owner-based identity propagation. */
+    observePlayerActor(actorId: number, tick: number): FishNetActorIdentityEvent[];
+    /** Clears per-connection state (spawned objects, owner mappings, in-session identity sources). */
+    reset(): void;
+    setLocalIdentity(identity: FishNetLocalIdentity): void;
+    private seedLocalIdentity;
+    private updateLocalIdentity;
+    private resolveSpawnIdentity;
+    private learnUidIdentity;
+    private changeOwner;
+    private removeObject;
+    private clearPlayerIdentity;
+    private refreshOwner;
+    private reconcile;
+    private addOwnerObject;
+    private removeOwnerObject;
+    private clear;
+}
+//# sourceMappingURL=actor-directory.d.ts.map

package/dist/actor-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-directory.d.ts","sourceRoot":"","sources":["../src/actor-directory.ts"],"names":[],"mappings":"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"}

package/dist/boss-catalog.d.ts

@@ -0,0 +1,6 @@
+import type { FishNetBossCatalog } from "./combat-tracker.ts";
+/** Makes the deliberately small, manually maintained boss registry explicit at each call site. */
+export declare function createBossCatalog(entries: Readonly<Record<string, string>>): FishNetBossCatalog;
+/** Registry for the bundled game build. */
+export declare const CURRENT_BOSS_SKILL_NAMES: FishNetBossCatalog;
+//# sourceMappingURL=boss-catalog.d.ts.map

package/dist/boss-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boss-catalog.d.ts","sourceRoot":"","sources":["../src/boss-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,kBAAkB,CAG/F;AAED,2CAA2C;AAC3C,eAAO,MAAM,wBAAwB,oBAAwB,CAAC"}

package/dist/combat-tracker.d.ts

@@ -0,0 +1,295 @@
+import type { DecodedFishNetPacket, FishNetDecodedValue, FishNetRecoveryStyle, FishNetSemanticMap } from "@kar-mi/spirit-vale-tools-capture";
+import type { FishNetSkillCatalog } from "@kar-mi/spirit-vale-tools-skills";
+export type FishNetCombatActionKind = "skill" | "basicAttack" | "inferred";
+export type FishNetCombatActionPhase = "begin" | "complete" | "interrupt" | "cancel" | "inferred";
+export type FishNetDamageAttribution = "exact" | "ambiguous" | "inferred";
+export type FishNetHitResult = "normal" | "critical" | "miss" | "blocked" | "dodged" | number;
+export interface FishNetCombatActorIdentity {
+    readonly displayName: string;
+    readonly archetype?: number;
+    readonly ownerConnectionId?: number;
+    readonly uid?: string;
+}
+/** Names a monster type. */
+export interface FishNetMonsterCatalog {
+    get(mobId: string): {
+        readonly level: number;
+        readonly displayName: string;
+    } | undefined;
+}
+/** Curated, build-scoped boss names keyed by a skill unique to that boss. */
+export interface FishNetBossCatalog {
+    get(skillId: string): {
+        readonly displayName: string;
+    } | undefined;
+}
+export interface FishNetCombatTrackerOptions {
+    /** Ticks to retain a completed activation for trailing hits. Defaults to 30. */
+    hitGraceTicks?: number;
+    /** Maximum age of an activation that never completes. Defaults to 900 ticks. */
+    activationMaxAgeTicks?: number;
+    /** Semantic labels for skill wire identifiers. Defaults to the current bundled build. */
+    semanticMap?: FishNetSemanticMap;
+    /** Extracted public skill metadata. Defaults to the current bundled build when available. */
+    skillCatalog?: FishNetSkillCatalog;
+    buildFingerprint?: string;
+    /** Resolves an attacker to a known player identity, including owner/UID continuity. */
+    actorIdentityResolver?: (actorId: number) => FishNetCombatActorIdentity | undefined;
+    /** Resolves healing mechanics for actors whose local character build is visible. */
+    healingTraitsResolver?: (actorId: number) => FishNetHealingTraits | undefined;
+    /** The local player's network object id, when known. */
+    localActorIdResolver?: () => number | undefined;
+    /** Names monsters seen spawning, emitting identity lifecycle events keyed by network object id. */
+    monsterCatalog?: FishNetMonsterCatalog;
+    /** Fallback names for otherwise-anonymous bosses; game-provided identities always win. */
+    bossCatalog?: FishNetBossCatalog;
+}
+export type FishNetCombatMonsterIdentityEvent = {
+    kind: "monsterIdentity";
+    operation: "upsert";
+    tick: number;
+    actorId: number;
+    mobId: string;
+    displayName: string;
+    actorIdentity?: never;
+} | {
+    kind: "monsterIdentity";
+    operation: "remove";
+    tick: number;
+    actorId: number;
+    actorIdentity?: never;
+} | {
+    kind: "monsterIdentity";
+    operation: "reset";
+    tick: number;
+    actorId?: never;
+    actorIdentity?: never;
+};
+export interface FishNetHealingTraits {
+    readonly hasSiphonHealth: boolean;
+    readonly hasHealthLeech: boolean;
+}
+export interface FishNetCombatActivationEvent {
+    kind: "activation";
+    rpc: string;
+    tick: number;
+    payloadBytes: number;
+    fields: Record<string, FishNetDecodedValue>;
+    actorId: number;
+    activationId?: string;
+    actionKind: FishNetCombatActionKind;
+    phase: FishNetCombatActionPhase;
+    sourceId?: string;
+    sourceLabel?: string;
+    targetId?: number;
+    level?: number;
+    attackIndex?: number;
+    inferred?: boolean;
+    actorIdentity?: FishNetCombatActorIdentity;
+}
+export interface FishNetCombatDamageEvent {
+    kind: "damage";
+    rpc: "ApplyDamage_C";
+    tick: number;
+    payloadBytes: number;
+    fields: Record<string, FishNetDecodedValue>;
+    actorId: number;
+    targetId: number;
+    sourceId: string;
+    sourceLabel: string;
+    value: number;
+    hitResult: FishNetHitResult;
+    wireHits: number;
+    damageType: number;
+    team: number;
+    element: number;
+    weaponType: number;
+    range: number;
+    isClone: boolean;
+    isSummon: boolean;
+    position: number[];
+    origin: number[];
+    attribution: FishNetDamageAttribution;
+    activationId?: string;
+    candidateActivationIds?: string[];
+    actorIdentity?: FishNetCombatActorIdentity;
+}
+export interface FishNetCombatDeathEvent {
+    kind: "death";
+    rpc: "Death_C";
+    tick: number;
+    payloadBytes: number;
+    fields: Record<string, FishNetDecodedValue>;
+    actorId: number;
+    targetId: number;
+    sourceId: string;
+    sourceLabel: string;
+    value: number;
+    hitResult: FishNetHitResult;
+    wireHits: number;
+    damageType: number;
+    team: number;
+    element: number;
+    weaponType: number;
+    range: number;
+    isClone: boolean;
+    isSummon: boolean;
+    attribution: FishNetDamageAttribution;
+    activationId?: string;
+    candidateActivationIds?: string[];
+    /** True when an identical ApplyDamage_C was already emitted at this tick. */
+    duplicatesDamageEvent: boolean;
+    actorIdentity?: FishNetCombatActorIdentity;
+}
+export interface FishNetCombatStatusEvent {
+    kind: "status";
+    rpc: "ApplyEffect_T" | "RemoveEffect_T" | "ApplyEffectDisplays_O" | "ApplySkillDisplay_O" | "RemoveSkillDisplay_O";
+    tick: number;
+    payloadBytes: number;
+    fields: Record<string, FishNetDecodedValue>;
+    actorId: number;
+    statusId: string;
+    /** Absent on `ApplyEffectDisplays_O`, which carries no level; consumers keep the last known one. */
+    level?: number;
+    action: "applied" | "removed";
+    /** Server-reported time left, from `ApplyEffectDisplays_O` only. */
+    remainingSeconds?: number;
+    stacks?: number;
+    actorIdentity?: FishNetCombatActorIdentity;
+}
+export interface FishNetCombatSummonEvent {
+    kind: "summon";
+    rpc: "CalibrateSummons_T";
+    tick: number;
+    payloadBytes: number;
+    fields: Record<string, FishNetDecodedValue>;
+    actorId: number;
+    skillId: string;
+    stacks: number;
+    /** True when the packet arrived unnamed and was recovered heuristically. See `recoverSummons`. */
+    recovered?: boolean;
+    actorIdentity?: FishNetCombatActorIdentity;
+}
+/** A `PlayerController.FullHeal_C`, which restores an actor outright. */
+interface FishNetCombatFullHealEvent {
+    kind: "fullHeal";
+    rpc: "FullHeal_C";
+    tick: number;
+    payloadBytes: number;
+    fields: Record<string, FishNetDecodedValue>;
+    /** The restored actor: the RPC's own object. There is no healer on the wire. */
+    targetId: number;
+    /** No one performed this heal, so no actor may be credited for it. */
+    actorId?: never;
+    actorIdentity?: FishNetCombatActorIdentity;
+}
+export type FishNetHealAttribution = FishNetDamageAttribution | "unattributed";
+export interface FishNetCombatHealEvent {
+    kind: "heal";
+    /** `ApplyDamage_C` is authoritative when its signed damage value is negative. */
+    rpc: "ApplyDamage_C" | "Recover_C";
+    tick: number;
+    payloadBytes: number;
+    fields: Record<string, FishNetDecodedValue>;
+    /** The healed entity — always known (it's the RPC's objectId). */
+    targetId: number;
+    /** The inferred healer, when attribution succeeds. Absent when fully unattributed or ambiguous. */
+    actorId?: number;
+    sourceId?: string;
+    sourceLabel?: string;
+    value: number;
+    /** Semantic style derived from the build-specific Recover_C FloaterSettings. */
+    recoveryStyle?: FishNetRecoveryStyle;
+    attribution: FishNetHealAttribution;
+    activationId?: string;
+    candidateActivationIds?: string[];
+    actorIdentity?: FishNetCombatActorIdentity;
+}
+export type FishNetCombatEvent = FishNetCombatMonsterIdentityEvent | FishNetCombatActivationEvent | FishNetCombatDamageEvent | FishNetCombatDeathEvent | FishNetCombatStatusEvent | FishNetCombatSummonEvent | FishNetCombatHealEvent | FishNetCombatFullHealEvent;
+/** Converts decoded FishNet RPCs into actor-grouped combat events and summaries. */
+export declare class FishNetCombatTracker {
+    private readonly hitGraceTicks;
+    private readonly activationMaxAgeTicks;
+    private readonly skillLabels;
+    private readonly actorIdentityResolver?;
+    private readonly healingTraitsResolver?;
+    private readonly localActorIdResolver?;
+    private readonly monsterCatalog?;
+    private readonly bossCatalog?;
+    private readonly monsters?;
+    private readonly semanticMap?;
+    private readonly activations;
+    /** Curated boss names are valid only for the lifetime of their network object id. */
+    private readonly bossIdentities;
+    private readonly activeRegenSources;
+    private readonly summonStacks;
+    private readonly recentDamageSignatures;
+    private recentDamageTick;
+    private nextActivation;
+    constructor(options?: FishNetCombatTrackerOptions);
+    consume(packet: DecodedFishNetPacket): FishNetCombatEvent[];
+    reset(): void;
+    private monsterIdentity;
+    /** Uses the normal monster-identity path so all consumers receive the curated boss name. */
+    private bossIdentity;
+    /**
+     * FishNet may reuse an object id in a later zone. Drop a curated boss name at every object
+     * lifetime boundary so the next boss cannot inherit the old one's identity before it casts.
+     */
+    private bossIdentityLifecycle;
+    /**
+     * Turns the observers-facing status broadcast into the same status events as the owner-only
+     * `ApplyEffect_T`/`RemoveEffect_T` pair.
+     *
+     * This feed reports every actor in range rather than just the local player, and it repeats
+     * periodically instead of only on change, so it both widens coverage and self-heals after a
+     * dropped packet. It reports real remaining time, which the owner-only path can only approximate
+     * from the catalog. It carries no level, so the events omit one and consumers keep whatever the
+     * owner-only feed last reported.
+     */
+    private consumeEffectDisplays;
+    /** Recovers only current-build payloads whose domain codec and component position both agree. */
+    private recoverAmbiguousCombat;
+    /**
+     * Turns the skill-icon display feed into status events.
+     *
+     * `ApplySkillDisplay_O`/`RemoveSkillDisplay_O` announce a *skill* shown on an actor - stances and
+     * auras such as `SilentEdge` that the effect feed does not report. Ids do overlap it in places
+     * (`FlowState`, `AngelicBlessing` appear on both), and this feed carries no timing at all, so it
+     * must never overwrite an expiry the effect feed established. `consumeStatus` enforces that by
+     * keeping a known expiry when an event brings none.
+     */
+    private consumeSkillDisplay;
+    /**
+     * Last-resort recovery for a `CalibrateSummons_T` the capture layer could not name. Two paths lose
+     * it. An rpcLink whose registration never arrived carries no object id, no hash and no name at all
+     * - links are only ever learned from an `objectSpawn`, so if the player object's spawn is missed on
+     * a connection, every link on that object is dead for the connection's whole life. A plain
+     * targetRpc on an object with no bound components fares little better: wire hash 0 is shared by
+     * several behaviours, and with nothing bound there is nothing to eliminate against. Either way the
+     * summon tile stays blank until a map change respawns the player object and re-registers its links.
+     *
+     * This is a heuristic and deliberately narrow. `decodeSummonCalibration` must consume the payload
+     * exactly, at least one entry must decode, every skill id must be one the catalog knows, and the
+     * result is attributed to the local player because `CalibrateSummons_T` is a targetRpc no other
+     * client receives. An empty calibration - the "all summons gone" snapshot - is *not* recovered: it
+     * encodes as a single 0x01 byte, which carries no signature worth trusting.
+     */
+    private recoverSummons;
+    private consumeSummonCalibration;
+    /** Diffs one summon snapshot against the actor's last known stacks and emits only the changes. */
+    private applySummonSnapshot;
+    private consumeSkill;
+    private beginAttack;
+    private consumeDamage;
+    private consumeRecover;
+    private createSelfRecovery;
+    private eligibleHealActivations;
+    private consumeStatus;
+    private createActivation;
+    private findLifecycleActivation;
+    private eligibleActivations;
+    private pruneExpired;
+}
+export {};
+//# sourceMappingURL=combat-tracker.d.ts.map

package/dist/combat-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combat-tracker.d.ts","sourceRoot":"","sources":["../src/combat-tracker.ts"],"names":[],"mappings":"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"}

package/dist/dps-meter.d.ts

@@ -0,0 +1,115 @@
+import type { FishNetActorIdentityEvent } from "./actor-directory.ts";
+import type { FishNetCombatEvent } from "./combat-tracker.ts";
+export interface FishNetDpsMeterOptions {
+    /** Milliseconds without positive player damage before a new encounter. Defaults to 30 seconds. */
+    idleGapMs?: number;
+    /** Minimum duration used as the DPS divisor. Defaults to one second. */
+    minimumDurationMs?: number;
+    /** Decay constant for current DPS. Defaults to 2.5 seconds, which matches a 5-second window's smoothing. */
+    currentTauSeconds?: number;
+    /** Milliseconds to wait for a late identity before showing unidentified damage. Defaults to ten seconds. */
+    anonymousIdentityGraceMs?: number;
+    /** FishNet ticks per second used for replay records without wall-clock timestamps. Defaults to 30. */
+    replayTicksPerSecond?: number;
+    personalName?: string;
+    personalActorId?: number;
+}
+export interface FishNetDpsSkillRow {
+    sourceId: string;
+    sourceLabel: string;
+    damage: number;
+    dps: number;
+    contribution: number;
+    hits: number;
+    criticalHits: number;
+    /** Critical hits as a fraction of total hits, when the skill has hit. */
+    critRate?: number;
+}
+export interface FishNetDpsTimelinePoint {
+    /** Milliseconds elapsed since the encounter began. */
+    elapsedMs: number;
+    /** Damage dealt during this time bucket. */
+    damage: number;
+    /** Damage dealt from encounter start through this time bucket. */
+    cumulativeDamage: number;
+    /** Damage per second for this time bucket. */
+    dps: number;
+}
+export interface FishNetDpsActorRow {
+    actorIds: number[];
+    displayName: string;
+    archetype?: number;
+    /** Milliseconds used as the DPS divisor and timeline span for this row. */
+    durationMs?: number;
+    /** Timestamp of this actor's most recent positive damage in the encounter. */
+    lastDamageAtMs?: number;
+    damage: number;
+    dps: number;
+    /**
+     * Recent damage per second: an exponentially-weighted rate, not a flat window of the last few
+     * seconds. It rises the instant a hit lands and then fades, so it never steps discontinuously as
+     * a hit ages out and never reads exactly zero after one.
+     */
+    currentDps: number;
+    contribution: number;
+    hits: number;
+    criticalHits: number;
+    /** Critical hits as a fraction of total hits, when the actor has hit. */
+    critRate?: number;
+    kills: number;
+    /** Number of distinct enemy object IDs damaged by this actor during the encounter. */
+    mobsHit: number;
+    skills: FishNetDpsSkillRow[];
+    timeline: FishNetDpsTimelinePoint[];
+    /** True when the row contains damage that has not been verified to a player identity. */
+    isUnidentified?: boolean;
+}
+export type FishNetPersonalMatch = "unconfigured" | "missing" | "matched" | "ambiguous";
+export interface FishNetDpsEncounterSnapshot {
+    id: string;
+    startedAtMs: number;
+    lastDamageAtMs: number;
+    endedAtMs?: number;
+    durationMs: number;
+    totalDamage: number;
+    partyDps: number;
+    partyCurrentDps: number;
+    actors: FishNetDpsActorRow[];
+    personalName: string;
+    personalMatch: FishNetPersonalMatch;
+    personal?: FishNetDpsActorRow;
+}
+/** Aggregates structured FishNet identity and combat events into encounter DPS summaries. */
+export declare class FishNetDpsMeter {
+    private readonly idleGapMs;
+    private readonly minimumDurationMs;
+    private readonly currentTauSeconds;
+    private readonly anonymousIdentityGraceMs;
+    private readonly replayTicksPerSecond;
+    private readonly finished;
+    private readonly identities;
+    private current?;
+    private nextEncounter;
+    private personalName;
+    private personalActorId?;
+    constructor(options?: FishNetDpsMeterOptions);
+    consumeIdentity(event: FishNetActorIdentityEvent, observedAtMs: number): void;
+    consumeCombat(event: FishNetCombatEvent, observedAtMs: number): void;
+    /** Finalizes an idle encounter. Calling this regularly keeps live status current. */
+    advance(observedAtMs: number): void;
+    /** Finalizes the current encounter; the next qualifying hit starts a new one. */
+    reset(observedAtMs?: number): void;
+    /** Discards all encounter statistics while retaining actor and personal configuration. */
+    clearEncounters(): void;
+    setPersonalName(name: string): void;
+    getPersonalName(): string;
+    setPersonalActorId(actorId: number | undefined): void;
+    getPersonalActorId(): number | undefined;
+    getSnapshots(nowMs?: number): FishNetDpsEncounterSnapshot[];
+    getLatestSnapshot(nowMs?: number): FishNetDpsEncounterSnapshot | undefined;
+    /** Maps a FishNet tick onto replay time relative to a caller-selected origin. */
+    replayTimeMs(tick: number, originTick: number, originTimeMs?: number): number;
+    private finishCurrent;
+    private snapshot;
+}
+//# sourceMappingURL=dps-meter.d.ts.map

package/dist/dps-meter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dps-meter.d.ts","sourceRoot":"","sources":["../src/dps-meter.ts"],"names":[],"mappings":"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"}

package/dist/effect-display.d.ts

@@ -0,0 +1,16 @@
+interface FishNetEffectDisplay {
+    statusId: string;
+    /** Seconds left on the status. */
+    remainingSeconds?: number;
+    stacks: number;
+    /** Server-declared stack ceiling; 0 where the status declares none. */
+    maxStacks: number;
+}
+export interface FishNetEffectDisplayBatch {
+    applies: FishNetEffectDisplay[];
+    removes: string[];
+}
+/** Decodes the batched status snapshot carried by `ApplyEffectDisplays_O`. */
+export declare function decodeEffectDisplays(payload: Buffer): FishNetEffectDisplayBatch;
+export {};
+//# sourceMappingURL=effect-display.d.ts.map

package/dist/effect-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-display.d.ts","sourceRoot":"","sources":["../src/effect-display.ts"],"names":[],"mappings":"AAGA,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,CA2C/E"}

package/dist/history/domain.d.ts

@@ -0,0 +1,6 @@
+import type { ReadModelDomain } from "@kar-mi/spirit-vale-tools-sqlite";
+/** Bump whenever the tables below change; only combat is dropped and re-indexed. */
+export declare const COMBAT_DOMAIN_VERSION = 7;
+export declare const COMBAT_DOMAIN_NAME = "combat";
+export declare function createCombatDomain(): ReadModelDomain;
+//# sourceMappingURL=domain.d.ts.map

package/dist/history/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/history/domain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AA0J3C,wBAAgB,kBAAkB,IAAI,eAAe,CAwBpD"}

package/dist/history/importer.d.ts

@@ -0,0 +1,12 @@
+import type { IndexStreamResult, ReadModel } from "@kar-mi/spirit-vale-tools-sqlite";
+import type { DamageReducerOptions } from "../reducers/damage.ts";
+export interface IndexCombatStreamOptions extends Pick<DamageReducerOptions, "idleGapMs" | "currentTauSeconds"> {
+    sessionId: string;
+    sourcePath: string;
+    batchBytes?: number;
+    /** Closes the encounter still in progress at the end of the log. */
+    finalize?: boolean;
+}
+/** Indexes one combat log into the read model. */
+export declare function indexCombatStream(model: ReadModel, options: IndexCombatStreamOptions): Promise<IndexStreamResult>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/history/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../src/history/importer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,iBAAiB,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAKzG,OAAO,KAAK,EAAkB,oBAAoB,EAAmD,MAAM,uBAAuB,CAAC;AAcnI,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,WAAW,GAAG,mBAAmB,CAAC;IAC7G,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,kDAAkD;AAClD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0GvH"}