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

package/dist/status-tracker.d.ts

@@ -0,0 +1,61 @@
+import type { FishNetStatusCatalog } from "@kar-mi/spirit-vale-tools-statuses";
+import type { FishNetSkillCatalog } from "@kar-mi/spirit-vale-tools-skills";
+import type { FishNetActorIdentityEvent } from "./actor-directory.ts";
+import type { FishNetCombatEvent, FishNetCombatStatusEvent, FishNetCombatSummonEvent } from "./combat-tracker.ts";
+export interface FishNetActiveStatus {
+    statusId: string;
+    displayName: string;
+    spriteId?: string;
+    isDebuff: boolean;
+    level: number;
+    appliedAtMs: number;
+    expiresAtMs?: number;
+    remainingMs?: number;
+    stacks?: number;
+}
+export interface FishNetStatusTrackerOptions {
+    /** Status metadata used to resolve durations by level. Defaults to the bundled catalog. */
+    statusCatalog?: FishNetStatusCatalog;
+    /** Skill metadata used to label summon-derived buffs. Defaults to the bundled catalog. */
+    skillCatalog?: FishNetSkillCatalog;
+}
+/** Tracks per-actor active buffs/debuffs from FishNet status apply/remove events. */
+export declare class FishNetStatusTracker {
+    private readonly directory;
+    private readonly skillDirectory;
+    private readonly active;
+    /** Actor display names, tracked independently of damage so statuses resolve before an actor has hit anything. */
+    private readonly identities;
+    /** Last known actorId per uid. */
+    private readonly actorIdByUid;
+    private revisionValue;
+    private nextExpiryRevision;
+    private nextExpiry?;
+    constructor(options?: FishNetStatusTrackerOptions);
+    /** Bumped only when the tracked set actually changed. */
+    get revision(): number;
+    /** Earliest moment a tracked status is due to disappear, or undefined when nothing is on a timer. */
+    nextExpiryAtMs(): number | undefined;
+    private touch;
+    consume(event: FishNetCombatEvent, observedAtMs: number): void;
+    consumeIdentity(event: FishNetActorIdentityEvent): void;
+    private migrateActive;
+    consumeStatus(event: FishNetCombatStatusEvent, observedAtMs: number): void;
+    /** Whether the status runs on a real countdown, as opposed to a toggle or aura the server merely keeps re-stating. */
+    private isTimed;
+    /** Picks the expiry to trust. */
+    private resolveExpiry;
+    consumeSummon(event: FishNetCombatSummonEvent, observedAtMs: number): void;
+    /** Refreshes a status's timer when one of its granting skills activates again. */
+    private consumeActivation;
+    /** Drops statuses whose computed duration has elapsed; servers do not always send an explicit remove. */
+    advance(nowMs: number): void;
+    getActiveStatuses(actorId: number, nowMs: number): FishNetActiveStatus[];
+    /** Merges active statuses across actor IDs that represent the same logical actor (e.g. after a respawn). */
+    getActiveStatusesForActors(actorIds: readonly number[], nowMs: number): FishNetActiveStatus[];
+    /** Resolves active statuses by display name, independent of whether that actor has dealt any damage. */
+    getActiveStatusesForName(personalName: string, nowMs: number): FishNetActiveStatus[];
+    /** Discards all tracked statuses, e.g. when the encounter/session resets. */
+    reset(): void;
+}
+//# sourceMappingURL=status-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status-tracker.d.ts","sourceRoot":"","sources":["../src/status-tracker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAEV,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,2FAA2F;IAC3F,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,0FAA0F;IAC1F,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAmBD,qFAAqF;AACrF,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IACxE,iHAAiH;IACjH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,UAAU,CAAC,CAAS;IAE5B,YAAY,OAAO,GAAE,2BAAgC,EAGpD;IAED,yDAAyD;IACzD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,qGAAqG;IACrG,cAAc,IAAI,MAAM,GAAG,SAAS,CAYnC;IAED,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAK7D;IAED,eAAe,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAoBtD;IAED,OAAO,CAAC,aAAa;IAYrB,aAAa,CAAC,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAqBzE;IAED,sHAAsH;IACtH,OAAO,CAAC,OAAO;IAIf,iCAAiC;IACjC,OAAO,CAAC,aAAa;IAwBrB,aAAa,CAAC,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAczE;IAED,kFAAkF;IAClF,OAAO,CAAC,iBAAiB;IAuBzB,yGAAyG;IACzG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAY3B;IAED,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAwBvE;IAED,4GAA4G;IAC5G,0BAA0B,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAS5F;IAED,wGAAwG;IACxG,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAOnF;IAED,6EAA6E;IAC7E,KAAK,IAAI,IAAI,CAKZ;CACF"}

package/dist/summon-calibration.d.ts

@@ -0,0 +1,8 @@
+export interface FishNetSummonCalibrationEntry {
+    skillId: string;
+    isPrimary: boolean;
+    isMountedSummon: boolean;
+}
+/** Decodes the complete summon snapshot carried by CalibrateSummons_T. */
+export declare function decodeSummonCalibration(payload: Buffer): FishNetSummonCalibrationEntry[];
+//# sourceMappingURL=summon-calibration.d.ts.map

package/dist/summon-calibration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summon-calibration.d.ts","sourceRoot":"","sources":["../src/summon-calibration.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,6BAA6B,EAAE,CAqBxF"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@kar-mi/spirit-vale-tools-combat",
+  "version": "3.3.5",
+  "description": "Spirit Vale combat event tracking and replay utilities.",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kar-mi/spirit-vale-tools.git",
+    "directory": "packages/combat"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --format esm --external '@kar-mi/spirit-vale-tools-*' && bunx tsc --project ./tsconfig.build.json"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@kar-mi/spirit-vale-tools-capture": "^2.3.0",
+    "@kar-mi/spirit-vale-tools-logging": "^0.9.0",
+    "@kar-mi/spirit-vale-tools-metrics": "^0.2.0",
+    "@kar-mi/spirit-vale-tools-skills": "^0.2.1",
+    "@kar-mi/spirit-vale-tools-sqlite": "^0.2.1",
+    "@kar-mi/spirit-vale-tools-statuses": "^0.2.3"
+  }
+}