@axiapps/bridge-metrics 0.1.0

package/dist/reportMetrics.cjs

@@ -0,0 +1,224 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/reportMetrics.ts
+var reportMetrics_exports = {};
+__export(reportMetrics_exports, {
+  ReportSchemaError: () => ReportSchemaError,
+  aggregatePlayers: () => aggregatePlayers,
+  compareRunSets: () => compareRunSets,
+  extractRunSummary: () => extractRunSummary
+});
+module.exports = __toCommonJS(reportMetrics_exports);
+var ReportSchemaError = class extends Error {
+};
+var num = (value) => {
+  const n = Number(value ?? 0);
+  return Number.isFinite(n) ? n : 0;
+};
+var extractRunSummary = (report) => {
+  const payload = report;
+  const id = String(payload?.meta?.id ?? "").trim();
+  if (!id) throw new ReportSchemaError("report has no meta.id \u2014 not an AxiBridge report.json");
+  const stats = payload?.stats ?? {};
+  const warnings = [];
+  const byAccount = /* @__PURE__ */ new Map();
+  const ensure = (row) => {
+    const account = String(row?.account ?? "").trim();
+    if (!account || account === "Unknown") return null;
+    let entry = byAccount.get(account);
+    if (!entry) {
+      entry = {
+        account,
+        profession: String(row?.profession ?? "Unknown"),
+        professionList: Array.isArray(row?.professionList) ? row.professionList.map(String) : [],
+        combatTimeMs: 0,
+        squadTimeMs: 0,
+        classTimes: [],
+        damage: 0,
+        downContribution: 0,
+        kills: 0,
+        downsCaused: 0,
+        strips: 0,
+        cleanses: 0,
+        resurrects: 0,
+        healing: 0,
+        barrier: 0,
+        hasHealAddon: false,
+        damageTaken: 0,
+        downs: 0,
+        deaths: 0,
+        logsJoined: 0
+      };
+      byAccount.set(account, entry);
+    }
+    return entry;
+  };
+  const tables = ["offensePlayers", "supportPlayers", "healingPlayers", "defensePlayers", "generalPlayers", "attendanceData"];
+  if (!tables.some((key) => Array.isArray(stats?.[key]) && stats[key].length > 0)) {
+    warnings.push("no player tables in report");
+  }
+  for (const row of Array.isArray(stats?.offensePlayers) ? stats.offensePlayers : []) {
+    const p = ensure(row);
+    if (!p) continue;
+    p.damage += num(row?.offenseTotals?.damage);
+    p.downContribution += num(row?.offenseTotals?.downContribution);
+    p.kills += num(row?.offenseTotals?.killed);
+    p.downsCaused += num(row?.offenseTotals?.downed);
+    p.strips = Math.max(p.strips, num(row?.offenseTotals?.boonStrips));
+  }
+  for (const row of Array.isArray(stats?.supportPlayers) ? stats.supportPlayers : []) {
+    const p = ensure(row);
+    if (!p) continue;
+    p.cleanses += num(row?.supportTotals?.condiCleanse);
+    p.strips = Math.max(p.strips, num(row?.supportTotals?.boonStrips));
+    p.resurrects += num(row?.supportTotals?.resurrects);
+    p.logsJoined = Math.max(p.logsJoined, num(row?.logsJoined));
+  }
+  for (const row of Array.isArray(stats?.healingPlayers) ? stats.healingPlayers : []) {
+    const p = ensure(row);
+    if (!p) continue;
+    p.healing += num(row?.healingTotals?.squadHealing ?? row?.healingTotals?.healing);
+    p.barrier += num(row?.healingTotals?.squadBarrier ?? row?.healingTotals?.barrier);
+    if (row?.hasHealAddon === true) p.hasHealAddon = true;
+  }
+  for (const row of Array.isArray(stats?.defensePlayers) ? stats.defensePlayers : []) {
+    const p = ensure(row);
+    if (!p) continue;
+    p.damageTaken += num(row?.defenseTotals?.damageTaken);
+    p.downs += num(row?.defenseTotals?.downCount);
+    p.deaths += num(row?.defenseTotals?.deadCount);
+  }
+  for (const row of Array.isArray(stats?.generalPlayers) ? stats.generalPlayers : []) {
+    const p = ensure(row);
+    if (!p) continue;
+    p.combatTimeMs = Math.max(p.combatTimeMs, num(row?.squadActiveMs ?? row?.totalFightMs));
+    p.logsJoined = Math.max(p.logsJoined, num(row?.logsJoined));
+  }
+  for (const row of Array.isArray(stats?.attendanceData) ? stats.attendanceData : []) {
+    const p = ensure(row);
+    if (!p) continue;
+    p.combatTimeMs = Math.max(p.combatTimeMs, num(row?.combatTimeMs));
+    p.squadTimeMs = Math.max(p.squadTimeMs, num(row?.squadTimeMs));
+    if (Array.isArray(row?.classTimes)) {
+      p.classTimes = row.classTimes.map((c) => ({ profession: String(c?.profession ?? ""), timeMs: num(c?.timeMs) })).filter((c) => c.profession && c.timeMs > 0);
+    }
+  }
+  return {
+    id,
+    title: String(payload?.meta?.title ?? id),
+    dateStart: payload?.meta?.dateStart ?? null,
+    dateEnd: payload?.meta?.dateEnd ?? null,
+    fights: num(stats?.total),
+    wins: num(stats?.wins),
+    losses: num(stats?.losses),
+    avgSquadSize: typeof stats?.avgSquadSize === "number" ? stats.avgSquadSize : null,
+    avgEnemies: typeof stats?.avgEnemies === "number" ? stats.avgEnemies : null,
+    squadDeaths: num(stats?.totalSquadDeaths),
+    squadDowns: num(stats?.totalSquadDowns),
+    enemyDeaths: num(stats?.totalEnemyDeaths),
+    enemyDowns: num(stats?.totalEnemyDowns),
+    commanders: Array.isArray(payload?.meta?.commanders) ? payload.meta.commanders.map(String) : [],
+    players: Array.from(byAccount.values()),
+    warnings
+  };
+};
+var aggregatePlayers = (summaries, accounts) => {
+  const wanted = accounts && accounts.length > 0 ? new Set(accounts.map((a) => a.toLowerCase())) : null;
+  const map = /* @__PURE__ */ new Map();
+  for (const run of summaries) {
+    for (const p of run.players) {
+      if (wanted && !wanted.has(p.account.toLowerCase())) continue;
+      let agg = map.get(p.account);
+      if (!agg) {
+        agg = {
+          account: p.account,
+          runsJoined: 0,
+          combatTimeMs: 0,
+          squadTimeMs: 0,
+          professionTimeMs: {},
+          damage: 0,
+          dps: 0,
+          downContribution: 0,
+          kills: 0,
+          strips: 0,
+          cleanses: 0,
+          resurrects: 0,
+          healing: 0,
+          barrier: 0,
+          damageTaken: 0,
+          downs: 0,
+          deaths: 0,
+          lastSeen: null
+        };
+        map.set(p.account, agg);
+      }
+      agg.runsJoined += 1;
+      agg.combatTimeMs += p.combatTimeMs;
+      agg.squadTimeMs += p.squadTimeMs;
+      for (const c of p.classTimes) {
+        agg.professionTimeMs[c.profession] = (agg.professionTimeMs[c.profession] || 0) + c.timeMs;
+      }
+      agg.damage += p.damage;
+      agg.downContribution += p.downContribution;
+      agg.kills += p.kills;
+      agg.strips += p.strips;
+      agg.cleanses += p.cleanses;
+      agg.resurrects += p.resurrects;
+      agg.healing += p.healing;
+      agg.barrier += p.barrier;
+      agg.damageTaken += p.damageTaken;
+      agg.downs += p.downs;
+      agg.deaths += p.deaths;
+      const seen = run.dateEnd ?? run.dateStart;
+      if (seen && (!agg.lastSeen || seen > agg.lastSeen)) agg.lastSeen = seen;
+    }
+  }
+  const rows = Array.from(map.values());
+  for (const row of rows) {
+    row.dps = row.combatTimeMs > 0 ? row.damage / (row.combatTimeMs / 1e3) : 0;
+  }
+  return rows.sort((a, b) => b.damage - a.damage);
+};
+var RUN_SET_METRICS = [
+  "fights",
+  "wins",
+  "losses",
+  "squadDeaths",
+  "squadDowns",
+  "enemyDeaths",
+  "enemyDowns"
+];
+var compareRunSets = (a, b) => {
+  const total = (runs, metric) => runs.reduce((sum, run) => sum + num(run[metric]), 0);
+  return {
+    metrics: RUN_SET_METRICS.map((metric) => {
+      const va = total(a, metric);
+      const vb = total(b, metric);
+      return { metric, a: va, b: vb, delta: vb - va, deltaPct: va !== 0 ? (vb - va) / va : null };
+    })
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ReportSchemaError,
+  aggregatePlayers,
+  compareRunSets,
+  extractRunSummary
+});

package/dist/reportMetrics.d.cts

@@ -0,0 +1,85 @@
+/**
+ * Report-level aggregation over PUBLISHED report.json payloads ({ meta, stats }).
+ * Defensive by design: published schemas vary across AxiBridge versions, so every
+ * field read is optional and failures surface as warnings or ReportSchemaError —
+ * never silent drops.
+ */
+declare class ReportSchemaError extends Error {
+}
+interface RunPlayerSummary {
+    account: string;
+    profession: string;
+    professionList: string[];
+    combatTimeMs: number;
+    squadTimeMs: number;
+    classTimes: Array<{
+        profession: string;
+        timeMs: number;
+    }>;
+    damage: number;
+    downContribution: number;
+    kills: number;
+    downsCaused: number;
+    strips: number;
+    cleanses: number;
+    resurrects: number;
+    healing: number;
+    barrier: number;
+    hasHealAddon: boolean;
+    damageTaken: number;
+    downs: number;
+    deaths: number;
+    logsJoined: number;
+}
+interface RunSummary {
+    id: string;
+    title: string;
+    dateStart: string | null;
+    dateEnd: string | null;
+    fights: number;
+    wins: number;
+    losses: number;
+    avgSquadSize: number | null;
+    avgEnemies: number | null;
+    squadDeaths: number;
+    squadDowns: number;
+    enemyDeaths: number;
+    enemyDowns: number;
+    commanders: string[];
+    players: RunPlayerSummary[];
+    warnings: string[];
+}
+declare const extractRunSummary: (report: unknown) => RunSummary;
+interface PlayerAggregate {
+    account: string;
+    runsJoined: number;
+    combatTimeMs: number;
+    squadTimeMs: number;
+    professionTimeMs: Record<string, number>;
+    damage: number;
+    dps: number;
+    downContribution: number;
+    kills: number;
+    strips: number;
+    cleanses: number;
+    resurrects: number;
+    healing: number;
+    barrier: number;
+    damageTaken: number;
+    downs: number;
+    deaths: number;
+    lastSeen: string | null;
+}
+declare const aggregatePlayers: (summaries: RunSummary[], accounts?: string[]) => PlayerAggregate[];
+interface RunSetComparison {
+    metrics: Array<{
+        metric: string;
+        a: number;
+        b: number;
+        delta: number;
+        deltaPct: number | null;
+    }>;
+}
+declare const compareRunSets: (a: RunSummary[], b: RunSummary[]) => RunSetComparison;
+
+export { type PlayerAggregate, ReportSchemaError, type RunPlayerSummary, type RunSetComparison, type RunSummary, aggregatePlayers, compareRunSets, extractRunSummary };

package/dist/reportMetrics.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Report-level aggregation over PUBLISHED report.json payloads ({ meta, stats }).
+ * Defensive by design: published schemas vary across AxiBridge versions, so every
+ * field read is optional and failures surface as warnings or ReportSchemaError —
+ * never silent drops.
+ */
+declare class ReportSchemaError extends Error {
+}
+interface RunPlayerSummary {
+    account: string;
+    profession: string;
+    professionList: string[];
+    combatTimeMs: number;
+    squadTimeMs: number;
+    classTimes: Array<{
+        profession: string;
+        timeMs: number;
+    }>;
+    damage: number;
+    downContribution: number;
+    kills: number;
+    downsCaused: number;
+    strips: number;
+    cleanses: number;
+    resurrects: number;
+    healing: number;
+    barrier: number;
+    hasHealAddon: boolean;
+    damageTaken: number;
+    downs: number;
+    deaths: number;
+    logsJoined: number;
+}
+interface RunSummary {
+    id: string;
+    title: string;
+    dateStart: string | null;
+    dateEnd: string | null;
+    fights: number;
+    wins: number;
+    losses: number;
+    avgSquadSize: number | null;
+    avgEnemies: number | null;
+    squadDeaths: number;
+    squadDowns: number;
+    enemyDeaths: number;
+    enemyDowns: number;
+    commanders: string[];
+    players: RunPlayerSummary[];
+    warnings: string[];
+}
+declare const extractRunSummary: (report: unknown) => RunSummary;
+interface PlayerAggregate {
+    account: string;
+    runsJoined: number;
+    combatTimeMs: number;
+    squadTimeMs: number;
+    professionTimeMs: Record<string, number>;
+    damage: number;
+    dps: number;
+    downContribution: number;
+    kills: number;
+    strips: number;
+    cleanses: number;
+    resurrects: number;
+    healing: number;
+    barrier: number;
+    damageTaken: number;
+    downs: number;
+    deaths: number;
+    lastSeen: string | null;
+}
+declare const aggregatePlayers: (summaries: RunSummary[], accounts?: string[]) => PlayerAggregate[];
+interface RunSetComparison {
+    metrics: Array<{
+        metric: string;
+        a: number;
+        b: number;
+        delta: number;
+        deltaPct: number | null;
+    }>;
+}
+declare const compareRunSets: (a: RunSummary[], b: RunSummary[]) => RunSetComparison;
+
+export { type PlayerAggregate, ReportSchemaError, type RunPlayerSummary, type RunSetComparison, type RunSummary, aggregatePlayers, compareRunSets, extractRunSummary };

package/dist/reportMetrics.js

@@ -0,0 +1,12 @@
+import {
+  ReportSchemaError,
+  aggregatePlayers,
+  compareRunSets,
+  extractRunSummary
+} from "./chunk-UFJJ6WLD.js";
+export {
+  ReportSchemaError,
+  aggregatePlayers,
+  compareRunSets,
+  extractRunSummary
+};

package/dist/resUtility.cjs

@@ -0,0 +1,52 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/resUtility.ts
+var resUtility_exports = {};
+__export(resUtility_exports, {
+  isResUtilitySkill: () => isResUtilitySkill
+});
+module.exports = __toCommonJS(resUtility_exports);
+
+// src/statsMetrics.ts
+var RES_UTILITY_NAME_MATCHES = [
+  "battle standard",
+  "glyph of renewal",
+  "glyph of the stars",
+  "illusion of life",
+  "spirit of nature",
+  "nature spirit",
+  "search and rescue",
+  "signet of mercy"
+];
+var RES_UTILITY_IDS = /* @__PURE__ */ new Set([10244]);
+
+// src/resUtility.ts
+var isResUtilitySkill = (id, skillMap) => {
+  if (RES_UTILITY_IDS.has(id)) {
+    return true;
+  }
+  const entry = skillMap?.[`s${id}`] || skillMap?.[`${id}`];
+  const name = entry?.name?.toLowerCase() || "";
+  return RES_UTILITY_NAME_MATCHES.some((match) => name.includes(match));
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isResUtilitySkill
+});

package/dist/resUtility.d.cts

@@ -0,0 +1,5 @@
+declare const isResUtilitySkill: (id: number, skillMap: Record<string, {
+    name?: string;
+}> | undefined) => boolean;
+
+export { isResUtilitySkill };

package/dist/resUtility.d.ts

@@ -0,0 +1,5 @@
+declare const isResUtilitySkill: (id: number, skillMap: Record<string, {
+    name?: string;
+}> | undefined) => boolean;
+
+export { isResUtilitySkill };

package/dist/resUtility.js

@@ -0,0 +1,8 @@
+import {
+  isResUtilitySkill
+} from "./chunk-JP2ZL44R.js";
+import "./chunk-42DVJJLC.js";
+import "./chunk-RGXSI3AI.js";
+export {
+  isResUtilitySkill
+};

package/dist/roles.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/roles.ts
+var roles_exports = {};
+module.exports = __toCommonJS(roles_exports);

package/dist/roles.d.cts

@@ -0,0 +1,17 @@
+interface RoleClassificationFactor {
+    metric: string;
+    value: number;
+    median: number;
+    ratio: number;
+    weight: number;
+    contribution: number;
+}
+interface PlayerRoleClassification {
+    role: 'support' | 'damage';
+    supportScore: number;
+    confidenceScore: number;
+    threshold: number;
+    factors: RoleClassificationFactor[];
+}
+
+export type { PlayerRoleClassification, RoleClassificationFactor };

package/dist/roles.d.ts

@@ -0,0 +1,17 @@
+interface RoleClassificationFactor {
+    metric: string;
+    value: number;
+    median: number;
+    ratio: number;
+    weight: number;
+    contribution: number;
+}
+interface PlayerRoleClassification {
+    role: 'support' | 'damage';
+    supportScore: number;
+    confidenceScore: number;
+    threshold: number;
+    factors: RoleClassificationFactor[];
+}
+
+export type { PlayerRoleClassification, RoleClassificationFactor };

package/dist/roles.js

@@ -0,0 +1 @@
+import "./chunk-4F55Q6K2.js";